Compartilhar via


Função GetSecurityDescriptorLength (securitybaseapi.h)

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

Confira também

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível

SECURITY_DESCRIPTOR