Função GetSecurityDescriptorSacl (securitybaseapi.h)

Artigo
03/05/2024

A função GetSecurityDescriptorSacl recupera um ponteiro para a SACL ( lista de controle de acesso do sistema ) em um descritor de segurança especificado.

Sintaxe

BOOL GetSecurityDescriptorSacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbSaclPresent,
  [out] PACL                 *pSacl,
  [out] LPBOOL               lpbSaclDefaulted
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para a estrutura SECURITY_DESCRIPTOR que contém a SACL para a qual a função recupera um ponteiro.

[out] lpbSaclPresent

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

[out] pSacl

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

Se a função armazenar um valor NULL no ponteiro apontado por pSacl, o descritor de segurança terá uma SACL NULL .

[out] lpbSaclDefaulted

Um ponteiro para um sinalizador definido como o valor do sinalizador SE_SACL_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL se houver uma SACL para o descritor de segurança.

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