Função GetSecurityDescriptorLength (securitybaseapi.h)

Artigo
03/15/2023

A função GetSecurityDescriptorLength retorna o comprimento, em bytes, de um descritor de segurança estruturalmente válido. O comprimento inclui o comprimento de todas as estruturas associadas.

Sintaxe

DWORD GetSecurityDescriptorLength(
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para a estrutura SECURITY_DESCRIPTOR cujo comprimento a função retorna. O ponteiro é considerado válido.

Retornar valor

Se a função for bem-sucedida, a função retornará o comprimento, em bytes, da estrutura SECURITY_DESCRIPTOR .

Se a estrutura SECURITY_DESCRIPTOR não for válida, o valor retornado será indefinido.

Comentários

O comprimento mínimo de um descritor de segurança é SECURITY_DESCRIPTOR_MIN_LENGTH. Um descritor de segurança desse comprimento não tem SIDs ( identificadores de segurança ) associados ou ACLs ( listas de controle de acesso ).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll