GetSidIdentifierAuthority function (securitybaseapi.h)

Article
02/22/2024

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