Freigeben über


GetSidLengthRequired-Funktion (securitybaseapi.h)

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

Weitere Informationen

Zugriffssteuerung Übersicht

AllocateAndInitializeSid

Grundlegende Access Control-Funktionen

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID