Función FindFirstFreeAce (securitybaseapi.h)

La función FindFirstFreeAce recupera un puntero al primer byte libre de una lista de control de acceso (ACL).

Sintaxis

BOOL FindFirstFreeAce(
  [in]  PACL   pAcl,
  [out] LPVOID *pAce
);

Parámetros

[in] pAcl

Puntero a una ACL.

[out] pAce

Dirección de un puntero a la primera posición libre de la ACL creada cuando la función devuelve. Si la ACL no es válida, este parámetro es NULL. Si la ACL está llena, este parámetro apunta al byte inmediatamente después de la ACL.

Valor devuelto

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

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

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

Consulte también

GetAce

GetAclInformation

Access Control de bajo nivel

Funciones de Access Control de bajo nivel