NetShareSetInfo

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
netapi32.lib
Header File
lmshare.h
Unicode
WinNT
Platform Notes
All LanMan APIs are UNICODE only

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
	The buf parameter points to an array of SHARE_INFO_1 structures.
	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.