Freigeben über


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

Weitere Informationen

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene

SECURITY_DESCRIPTOR