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 |