Compartilhar via


Função GetSecurityDescriptorSacl (securitybaseapi.h)

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

Confira também

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Controle de Acesso de baixo nível

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

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorSacl