Edit

Share via

NetAccessGetInfo function (lmaccess.h)

  • Article

[This function is obsolete. For a list of alternate functions, see Authorization Functions.]

Not supported.

The NetAccessGetInfo function retrieves the access control list (ACL) for a specified resource.

Syntax

NET_API_STATUS NET_API_FUNCTION NetAccessGetInfo(
  LPCWSTR servername,
  LPCWSTR resource,
  DWORD   level,
  LPBYTE  *bufptr
);

Parameters

servername

Pointer to a string that specifies the DNS or NetBIOS name of the remote server on which the function is to execute. If this parameter is NULL, the local computer is used.

resource

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

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

level

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

bufptr

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

Return value

If the function succeeds, the return value is NERR_Success.

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

Remarks

This function requires Admin privilege to successfully execute on a computer that has local security enabled.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header lmaccess.h (include Lm.h, Lmaccess.h)
Library Netapi32.lib
DLL Netapi32.dll

See also

Authorization Functions