Freigeben über


GetSidIdentifierAuthority-Funktion (securitybaseapi.h)

Die GetSidIdentifierAuthority-Funktion gibt einen Zeiger auf die SID_IDENTIFIER_AUTHORITY-Struktur in einer angegebenen Sicherheits-ID (SID) zurück.

Syntax

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

Parameter

[in] pSid

Ein Zeiger auf die SID-Struktur , für die ein Zeiger auf die SID_IDENTIFIER_AUTHORITY-Struktur zurückgegeben wird.

Diese Funktion verarbeitet keine gültigen SID-Strukturen . Rufen Sie die IsValidSid-Funktion auf, um zu überprüfen, ob die SID-Struktur gültig ist, bevor Sie diese Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf die SID_IDENTIFIER_AUTHORITY-Struktur für die angegebene SID-Struktur .

Wenn die Funktion fehlschlägt, ist der Rückgabewert nicht definiert. Die Funktion schlägt fehl, wenn die SID-Struktur , auf die der pSid-Parameter verweist, ungültig ist. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion verwendet einen 32-Bit-RID-Wert. Für Anwendungen, die einen größeren RID-Wert erfordern, verwenden Sie CreateWellKnownSid und zugehörige Funktionen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile securitybaseapi.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY