Platform SDK: Network Management

NetSecurityGetInfo

Windows 95/98: The NetSecurityGetInfo function retrieves the specified level of access control information.

Windows NT/2000: This function is not supported on Windows NT/Windows 2000.

Security Requirements

When this function executes locally, no special privilege is required.

extern API_FUNCTION
 NetSecurityGetInfo(
  const char FAR * pszServer,        
  short sLevel,                      
  char FAR * pbBuffer,               
  unsigned short  cbBuffer,          
  unsigned short FAR * pcbTotalAvail 
);
 

Parameters

pszServer
Pointer to an ASCIIZ 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.
sLevel
Specifies the information level of the data. This parameter can be the following value.
Value Meaning
1 The pbBuffer parameter points to a security_info_1 structure.

pbBuffer
Pointer to the buffer that receives the security information structure.
cbBuffer
Specifies the size, in bytes, of the buffer pointed to by the pbBuffer parameter.
pcbTotalAvail
Pointer to an unsigned short integer that receives the total number of entries available.

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.

Remarks

Windows 95/98: See the NetSecurityGetInfo Sample (Windows 95/98) topic to view a code sample that demonstrates how to call the NetSecurityGetInfo function.

Requirements

  Windows NT/2000: Unsupported.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Svrapi.h.
  Library: Use Svrapi.lib.

See Also

Network Management Overview, Network Management Functions, security_info_1, NetAccessGetInfo