Función DeleteAce (securitybaseapi.h)

Artículo
08/25/2023

La función DeleteAce elimina una entrada de control de acceso (ACE) de una lista de control de acceso (ACL).

Sintaxis

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

Parámetros

[in, out] pAcl

Puntero a una ACL. La ACE especificada por el parámetro dwAceIndex se quita de esta ACL.

[in] dwAceIndex

ACE que se va a eliminar. Un valor de cero corresponde a la primera ACE de la ACL, un valor de uno a la segunda ACE, etc.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Una aplicación puede usar la estructura de ACL_SIZE_INFORMATION recuperada por la función GetAclInformation para detectar el tamaño de la ACL y el número de ACL que contiene. La función GetAce recupera información sobre una ACE individual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll