Função SetSecurityDescriptorSacl (securitybaseapi.h)

Artigo
03/01/2024

A função SetSecurityDescriptorSacl define informações em uma SACL ( lista de controle de acesso do sistema ). Se já houver uma SACL presente no descritor de segurança, ela será substituída.

Sintaxe

BOOL SetSecurityDescriptorSacl(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]           BOOL                 bSaclPresent,
  [in, optional] PACL                 pSacl,
  [in]           BOOL                 bSaclDefaulted
);

Parâmetros

[in, out] pSecurityDescriptor

Um ponteiro para a estrutura SECURITY_DESCRIPTOR à qual a função adiciona a SACL. Esse descritor de segurança deve estar em formato absoluto, o que significa que seus membros devem ser ponteiros para outras estruturas, em vez de deslocamentos para dados contíguos.

[in] bSaclPresent

Indica a presença de uma SACL no descritor de segurança. Se esse parâmetro for TRUE, a função definirá o sinalizador SE_SACL_PRESENT na estrutura SECURITY_DESCRIPTOR_CONTROL e usará os valores nos parâmetros pSacl e bSaclDefaulted . Se for FALSE, a função não definirá o sinalizador SE_SACL_PRESENT e pSacl e bSaclDefaulted serão ignorados.

[in, optional] pSacl

Um ponteiro para uma estrutura de ACL que especifica a SACL para o descritor de segurança. Se esse parâmetro for NULL, uma SACL NULL será atribuída ao descritor de segurança. A SACL é referenciada pelo descritor de segurança, não copiado.

[in] bSaclDefaulted

Indica a origem da SACL. Se esse sinalizador for TRUE, a SACL será recuperada por algum mecanismo padrão. Se for FALSE, a SACL foi especificada explicitamente por um usuário. A função armazena esse valor no sinalizador SE_SACL_DEFAULTED da estrutura SECURITY_DESCRIPTOR_CONTROL . Se esse parâmetro não estiver especificado, o sinalizador SE_SACL_DEFAULTED estará limpo.

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