Edit

Share via

NetAccessGetUserPerms function (lmaccess.h)

  • Article

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

Not supported.

The NetAccessGetUserPerms function returns a specified user's or group's access permissions for a particular resource.

Syntax

NET_API_STATUS NET_API_FUNCTION NetAccessGetUserPerms(
  LPCWSTR servername,
  LPCWSTR UGname,
  LPCWSTR resource,
  LPDWORD Perms
);

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.

UGname

Pointer to a string that specifies the name of the user or group to query.

resource

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

Perms

Pointer to an unsigned short integer that receives the user permissions for the specified resource.

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. When users request their own access permissions, no special privilege is required.

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