GetSidSubAuthorityCount-Funktion (securitybaseapi.h)

Artikel
03/04/2024

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