GetSidLengthRequired-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Die GetSidLengthRequired-Funktion gibt die Länge des Puffers in Bytes zurück, die zum Speichern einer SID mit einer angegebenen Anzahl von Unterautoritäten erforderlich ist.

Syntax

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

Parameter

[in] nSubAuthorityCount

Gibt die Anzahl der Unterautoritäten an, die in der SID-Struktur gespeichert werden sollen.

Rückgabewert

Der Rückgabewert ist die Länge des Puffers in Bytes, der zum Speichern der SID-Struktur erforderlich ist. Diese Funktion kann nicht fehlschlagen.

Hinweise

Die in nSubAuthorityCount angegebene SID-Struktur verwendet einen 32-Bit-RID-Wert. Für Anwendungen, die längere RID-Werte erfordern, verwenden Sie CreateWellKnownSid und zugehörige Funktionen.

Anforderungen


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