GetSidSubAuthority
The GetSidSubAuthority
function returns the address of a specified subauthority in a SID structure. The subauthority
value is a relative identifier (RID). A SID is a security identifier.
PDWORD GetSidSubAuthority(
|
PSID pSid, |
// address of
security identifier to query |
|
DWORD nSubAuthority |
// index of
subauthority to retrieve |
|
); |
|
Parameters
pSid
Points to the
SID structure from which the address of a subauthority is to be
returned.
nSubAuthority
Specifies an
index value identifying the subauthority array element whose address the
function will return. The function performs no validation tests on this value.
An application can call the GetSidSubAuthorityCount function to discover
the range of acceptable values.
Return Values
If the
function succeeds, the return value is the address of the specified SID
subauthority. To get extended error information, call GetLastError.
If the
function fails, the return value is undefined. The function fails if the specified
SID structure is invalid or if the index value specified by the nSubAuthority
parameter is out of bounds.
See Also