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 |