NetShareSetInfo
The NetShareSetInfo
function sets the parameters of a shared resource.
Security Requirements
Only the
Administrators local group or Communication, Print, or Server operator group
membership is required to successfully execute NetShareSetInfo. The
Print operator can set information only about Printer queues. The Communication
operator can set information only about communication-device queues.
NET_API_STATUS NetShareSetInfo(
|
LPTSTR servername, |
|
|
LPTSTR netname, |
|
|
DWORD level, |
|
|
LPBYTE buf, |
|
|
LPDWORD parm_err |
|
|
); |
|
Parameters
servername
Pointer to a
Unicode string containing the name of the remote server on which the function
is to execute. A NULL pointer or string specifies the local computer.
netname
Pointer to a
Unicode string containing the network name of the share to set information on.
level
Specifies one
of the following values to set the level of information provided.
|
Value |
Meaning |
|
1 |
The buf
parameter points to an array of SHARE_INFO_13NWOKVQ structures. |
|
2 |
The buf
parameter points to an array of SHARE_INFO_23NXOKVQ structures. |
|
502 |
The buf
parameter points to an array of SHARE_INFO_502 structures. |
|
1004 |
The buf
parameter points to an array of SHARE_INFO_1004 structures. |
|
1006 |
The buf
parameter points to an array of SHARE_INFO_1006 structures. |
|
1501 |
The buf
parameter points to an array of SHARE_INFO_1501 structures. |
buf
Pointer to
the buffer in which the data set with the level parameter is stored.
parm_err
Optional
pointer to a DWORD that contains the index of the first parameter that
causes ERROR_INVALID_PARAMETER. If NULL, the parameter is not returned on
error.
See Also