Compartilhar via


Função SetSecurityDescriptorSacl (securitybaseapi.h)

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

Confira também

ACL

GetSecurityDescriptorSacl

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Controle de Acesso de baixo nível

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

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner