LookupPrivilegeValue
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