GetSidSubAuthorityCount-Funktion (securitybaseapi.h)
Die GetSidSubAuthorityCount-Funktion gibt einen Zeiger auf den Member in einer Sicherheitsbezeichnerstruktur (SID) zurück, die die Anzahl der Unterautoritäten enthält.
Syntax
PUCHAR GetSidSubAuthorityCount(
[in] PSID pSid
);
Parameter
[in] pSid
Ein Zeiger auf die SID-Struktur , von der ein Zeiger auf die Anzahl der Unterautoritäten zurückgegeben wird.
Diese Funktion verarbeitet keine SID-Strukturen , die ungültig sind. 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 Anzahl der Unterautoritäten für die angegebene SID-Struktur .
Wenn die Funktion fehlschlägt, ist der Rückgabewert nicht definiert. Die Funktion schlägt fehl, wenn die angegebene SID-Struktur ungültig ist. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die in pSid angegebene SID-Struktur verwendet einen 32-Bit-Wert. Verwenden Sie für Anwendungen, die längere RID-Werte erfordern, 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ßen von Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |