GetSecurityDescriptorLength-Funktion (securitybaseapi.h)
Die GetSecurityDescriptorLength-Funktion gibt die Länge eines strukturell gültigen Sicherheitsdeskriptors in Bytes zurück. Die Länge umfasst die Länge aller zugeordneten Strukturen.
Syntax
DWORD GetSecurityDescriptorLength(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parameter
[in] pSecurityDescriptor
Ein Zeiger auf die SECURITY_DESCRIPTOR Struktur, deren Länge die Funktion zurückgibt. Der Zeiger wird als gültig angenommen.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion die Länge der SECURITY_DESCRIPTOR-Struktur in Bytes zurück.
Wenn die SECURITY_DESCRIPTOR-Struktur ungültig ist, ist der Rückgabewert nicht definiert.
Hinweise
Die Mindestlänge eines Sicherheitsdeskriptors ist SECURITY_DESCRIPTOR_MIN_LENGTH. Eine Sicherheitsbeschreibung dieser Länge weist keine zugeordneten Sicherheitsbezeichner (SIDs) oder Zugriffssteuerungslisten (Access Control Lists , ACLs) auf.
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ßlich Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |