Função GetSecurityDescriptorDacl (securitybaseapi.h)

Artigo
08/25/2023

A função GetSecurityDescriptorDacl recupera um ponteiro para a DACL ( lista de controle de acesso discricionário ) em um descritor de segurança especificado.

Sintaxe

BOOL GetSecurityDescriptorDacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbDaclPresent,
  [out] PACL                 *pDacl,
  [out] LPBOOL               lpbDaclDefaulted
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para a estrutura SECURITY_DESCRIPTOR que contém a DACL. A função recupera um ponteiro para ela.

[out] lpbDaclPresent

Um ponteiro para um valor que indica a presença de uma DACL no descritor de segurança especificado. Se lpbDaclPresent for TRUE, o descritor de segurança conterá uma DACL e os parâmetros de saída restantes nessa função receberão valores válidos. Se lpbDaclPresent for FALSE, o descritor de segurança não conterá uma DACL e os parâmetros de saída restantes não receberão valores válidos.

Um valor true paralpbDaclPresent não significa que pDacl não é NULL. Ou seja, lpbDaclPresent pode ser TRUE enquanto pDacl é NULL, o que significa que uma DACL NULL está em vigor. Uma DACL NULL permite implicitamente todo o acesso a um objeto e não é igual a uma DACL vazia. Uma DACL vazia não permite acesso a um objeto . Para obter informações sobre como criar uma DACL adequada, consulte Criando uma DACL.

[out] pDacl

Um ponteiro para um ponteiro para uma ACL ( lista de controle de acesso ). Se houver uma DACL, a função definirá o ponteiro apontado por pDacl para o endereço da DACL do descritor de segurança. Se uma DACL não existir, nenhum valor será armazenado.

Se a função armazenar um valor NULL no ponteiro apontado por pDacl, o descritor de segurança terá uma DACL NULL . Uma DACL NULL permite implicitamente todo o acesso a um objeto .

Se um aplicativo espera uma DACL não NULL , mas encontra uma DACL NULL , o aplicativo deve falhar com segurança e não permitir o acesso.

[out] lpbDaclDefaulted

Um ponteiro para um sinalizador definido como o valor do sinalizador SE_DACL_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL se houver uma DACL para o descritor de segurança. Se esse sinalizador for TRUE, a DACL foi recuperada por um mecanismo padrão; se FALSE, a DACL foi especificada explicitamente por um usuário.

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

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