GetUserObjectSecurity
The GetUserObjectSecurity
function retrieves security information for the specified user object.
BOOL GetUserObjectSecurity(
|
HANDLE hObj, |
// handle of user
object |
|
PSECURITY_INFORMATION pSIRequested, |
// address of
requested security information |
|
PSECURITY_DESCRIPTOR pSID, |
// address of
security descriptor |
|
DWORD nLength, |
// size of buffer
for security descriptor |
|
LPDWORD lpnLengthNeeded |
// address of
required size of buffer |
|
); |
|
Parameters
hObj
Identifies
the user object for which to return security information.
pSIRequested
Points to a SECURITY_INFORMATION structure specifying the
security information being requested.
pSID
Points to a SECURITY_DESCRIPTOR structure in self-relative
format that contains the requested information when the function returns.
nLength
Specifies the
length, in bytes, of the buffer pointed to by the pSID parameter.
lpnLengthNeeded
Points to a
variable receiving the number of bytes required to store the complete security
descriptor. If this variable s value is greater than the value of the nLength
parameter when the function returns, the function returns FALSE and none of the
security descriptor is copied to the buffer. Otherwise, the entire security
descriptor is copied.
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.
See Also