Función DeleteAce (securitybaseapi.h)

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

Consulte también

ACL_SIZE_INFORMATION

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAce

GetAclInformation

Access Control de bajo nivel

Funciones de Access Control de bajo nivel