Prev Next
The LookupPrivilegeValue function retrieves the locally unique
identifier (LUID) used on a specified system to locally represent the
specified privilege name.
BOOL LookupPrivilegeValue(
|
LPCTSTR lpSystemName,
|
// address of string specifying the system
|
|
LPCTSTR lpName,
|
// address of string specifying the privilege
|
|
PLUID lpLuid
|
// address of locally unique identifier
|
|
);
|
|
Parameters
-
lpSystemName
-
Points to a null-terminated string specifying the name of the system on which
the privilege name is looked up. If a null string is specified, the function
attempts to find the privilege name on the local system.
-
lpName
-
Points to a null-terminated string that specifies the name of the privilege,
as defined in the WINNT.H header file. For example, this parameter could
specify the constant SE_SECURITY_NAME, or its corresponding string,
“SeSecurityPrivilege”.
-
lpLuid
-
Points to a variable that receives the locally unique identifier by which the
privilege is known on the system specified by the lpSystemName
parameter.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
For this release of Windows NT, only the privileges specified in the Defined
Privileges section of WINNT.H are supported by this function.
See Also
LookupPrivilegeDisplayName,
LookupPrivilegeName