GetSidIdentifierAuthority function

The GetSidIdentifierAuthority function returns a pointer to the SID_IDENTIFIER_AUTHORITY structure in a specified security identifier (SID).

Syntax

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  PSID pSid
);

Parameters

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

   
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

See Also

Access Control Overview

Basic Access Control Functions

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY