Função SetSecurityDescriptorControl (securitybaseapi.h)

Artigo
08/25/2023

A função SetSecurityDescriptorControl define os bits de controle de um descritor de segurança. A função pode definir apenas os bits de controle relacionados à herança automática de ACEs. Para definir os outros bits de controle de um descritor de segurança, use as funções, como SetSecurityDescriptorDacl, para modificar os componentes de um descritor de segurança.

Sintaxe

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR cujas informações de controle e revisão estão definidas.

[in] ControlBitsOfInterest

Uma máscara de SECURITY_DESCRIPTOR_CONTROL que indica os bits de controle a serem definidos.

[in] ControlBitsToSet

Uma máscara de SECURITY_DESCRIPTOR_CONTROL que indica os novos valores para os bits de controle especificados pela máscara ControlBitsOfInterest .

Valor retornado

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

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

Comentários

A função SetSecurityDescriptorControl especifica o bit de controle ou os bits a serem modificados e se os bits estão ativados ou desativados.

Exemplos

O exemplo a seguir marca a DACL no descritor de segurança como protegida.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

O exemplo a seguir marca a DACL como não protegida.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

Requisitos


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