Compartilhar via


Função SetSecurityDescriptorControl (securitybaseapi.h)

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

Confira também

Visão geral do Controle de Acesso

Funções de Controle de Acesso básicas

GetSecurityDescriptorControl

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl