NetAccessSetInfo

Windows 95/98: The NetAccessSetInfo function changes the access-control list (ACL) for a resource.

Windows NT/2000: The NetAccessSetInfo function is obsolete on Windows NT/Windows 2000. Win32-based applications should use the GetFileSecurity and SetFileSecurity functions.

Security Requirements

Requires Admin privilege to successfully execute on a computer that has local security enabled.

extern API_FUNCTION
 NetAccessSetInfo(
  const char FAR * pszServer, 
  char FAR * pszResource, 
  short sLevel, 
  char FAR * pbBuffer, 
  unsigned short cbBuffer, 
  short sParmNum 
);

Parameters

pszServer

Pointer to a string specifying the name of the remote server on which the function is to execute. The string must begin with \\. If this parameter is NULL, the local computer is used.

pszResource

Pointer to a string that contains the name of the network resource to modify.

sLevel

Specifies the information level of the data. This parameter can be the following value.

Value	Meaning
1	The pbBuffer parameter points to an access_info_1 structure.

pbBuffer

Pointer to the buffer that contains the access information structure. The format of this data depends on the value of the sLevel parameter.

cbBuffer

Specifies the size, in bytes, of the buffer pointed to by the pbBuffer parameter.

sParmNum

This parameter must be equal to PARMNUM_ALL.

Return Values

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a Win32 API error code. For a list of error codes, see Error Codes.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Lmaccess.h (Windows NT/2000) or Svrapi.h (Windows 95/98); include Lm.h (Windows NT/2000).
  Library: Use Netapi32.lib (Windows NT/2000) or Svrapi.lib (Windows 95/98).

See Also

Network Management Overview, Network Management Functions, Access Functions, access_list, access_info_1, NetAccessGetInfo