Freigeben über


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

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

IsValidSid

SID