Função DeleteAce (securitybaseapi.h)

Artigo
03/01/2024

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