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 |