GetSidIdentifierAuthority function (securitybaseapi.h)
The GetSidIdentifierAuthority function returns a pointer to the SID_IDENTIFIER_AUTHORITY structure in a specified security identifier (SID).
Syntax
PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
[in] PSID pSid
);
Parameters
[in] pSid
A pointer to the SID structure for which a pointer to the SID_IDENTIFIER_AUTHORITY structure is returned.
This function does not handle SID structures that are not valid. Call the IsValidSid function to verify that the SID structure is valid before you call this function.
Return value
If the function succeeds, the return value is a pointer to the SID_IDENTIFIER_AUTHORITY structure for the specified SID structure.
If the function fails, the return value is undefined. The function fails if the SID structure pointed to by the pSid parameter is not valid. To get extended error information, call GetLastError.
Remarks
This function uses a 32-bit RID value. For applications that require a larger RID value, use CreateWellKnownSid and related functions.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2003 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | securitybaseapi.h (include Windows.h) |
| Library | Advapi32.lib |
| DLL | Advapi32.dll |