Compartilhar via


Função DeleteAce (securitybaseapi.h)

A função DeleteAce exclui uma ACE ( entrada de controle de acesso ) de uma ACL (lista de controle de acesso ).

Sintaxe

BOOL DeleteAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceIndex
);

Parâmetros

[in, out] pAcl

Um ponteiro para uma ACL. A ACE especificada pelo parâmetro dwAceIndex é removida dessa ACL.

[in] dwAceIndex

A ACE a ser excluída. Um valor zero corresponde ao primeiro ACE na ACL, um valor de um para o segundo ACE e assim por diante.

Retornar valor

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

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

Comentários

Um aplicativo pode usar a estrutura ACL_SIZE_INFORMATION recuperada pela função GetAclInformation para descobrir o tamanho da ACL e o número de ACEs que ela contém. A função GetAce recupera informações sobre uma ACE individual.

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_SIZE_INFORMATION

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAce

GetAclInformation

Controle de Acesso de baixo nível

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