Função FindFirstFreeAce (securitybaseapi.h)

A função FindFirstFreeAce recupera um ponteiro para o primeiro byte gratuito em uma ACL ( lista de controle de acesso ).

Sintaxe

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

Parâmetros

[in] pAcl

Um ponteiro para uma ACL.

[out] pAce

O endereço de um ponteiro para a primeira posição livre na ACL criada quando a função retorna. Se a ACL não for válida, esse parâmetro será NULL. Se a ACL estiver cheia, esse parâmetro apontará para o byte imediatamente após a ACL.

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

GetAce

GetAclInformation

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível