GetSidIdentifierAuthority-Funktion (securitybaseapi.h)

2024-03-06

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