Función GetSecurityDescriptorLength (securitybaseapi.h)

Artículo
03/01/2024

La función GetSecurityDescriptorLength devuelve la longitud, en bytes, de un descriptor de seguridad estructuralmente válido. La longitud incluye la longitud de todas las estructuras asociadas.

Sintaxis

DWORD GetSecurityDescriptorLength(
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parámetros

[in] pSecurityDescriptor

Puntero a la estructura SECURITY_DESCRIPTOR cuya longitud devuelve la función. Se supone que el puntero es válido.

Valor devuelto

Si la función se realiza correctamente, la función devuelve la longitud, en bytes, de la estructura SECURITY_DESCRIPTOR .

Si la estructura SECURITY_DESCRIPTOR no es válida, el valor devuelto no está definido.

Comentarios

La longitud mínima de un descriptor de seguridad es SECURITY_DESCRIPTOR_MIN_LENGTH. Un descriptor de seguridad de esta longitud no tiene identificadores de seguridad asociados (SID) ni listas de control de acceso (ACL).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll