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(
  LPWSTR servername, 
  LPWSTR 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_1 structures.
2 The buf parameter points to an array of SHARE_INFO_2 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.

Return Values

If the function returns account information, the return value is NERR_Success.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The user does not have access to the requested information.
ERROR_INVALID_LEVEL The value specified for the Level parameter is invalid.
ERROR_INVALID_PARAMETER The specified parameter is invalid.
NERR_NetNameNotFound The sharename does not exist.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in lmshare.h.
  Import Library: Use netapi32.lib (Windows NT) or svrapi.lib (Windows 95).

See Also

Networking (Net) Overview, Net Functions, NetShareGetInfo