GetSecurityDescriptorLength-Funktion (securitybaseapi.h)

Artikel
03/01/2024

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