Función RtlDeleteAce (ntifs.h)
La rutina RtlDeleteAce elimina una entrada de control de acceso (ACE) de una lista de control de acceso (ACL) especificada.
Sintaxis
NTSYSAPI NTSTATUS RtlDeleteAce(
[in, out] PACL Acl,
[in] ULONG AceIndex
);
Parámetros
[in, out] Acl
Puntero a la ACL que se va a modificar. RtlDeleteAce elimina la ACE especificada de esta ACL.
[in] AceIndex
Especifica la ACE que se va a eliminar. Un valor de cero corresponde a la primera ACE de la ACL, 1 a la segunda ACE, etc.
Valor devuelto
RtlDeleteAce devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Uno de los valores de parámetro no era válido. |
Entre las posibles razones de STATUS_INVALID_PARAMETER se incluyen:
- La ACL especificada no es válida.
- El valor de índice especificado está fuera del intervalo.
- STATUS_INVALID_PARAMETER es un código de error.
Comentarios
Para obtener información sobre cómo calcular el tamaño de una ACL, vea la sección Comentarios de la entrada de referencia para RtlCreateAcl.
Para agregar una ACE a una ACL, use RtlAddAce.
Para obtener un puntero a una ACE en una ACL, use RtlGetAce.
Para obtener más información sobre la seguridad y el control de acceso, consulte Modelo de seguridad de Windows para desarrolladores de controladores y la documentación sobre estos temas en Windows SDK.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Server 2003 SP1 |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |