Funzione FindFirstFreeAce (securitybaseapi.h)

La funzione FindFirstFreeAce recupera un puntatore al primo byte libero in un elenco di controllo di accesso .The FindFirstFreeAce function retrieve a pointer to the first free byte in an access control list (ACL).

Sintassi

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

Parametri

[in] pAcl

Puntatore a un elenco di controllo di accesso.

[out] pAce

Indirizzo di un puntatore alla prima posizione libera nell'ACL creato quando la funzione restituisce. Se l'ACL non è valido, questo parametro è NULL. Se l'ACL è pieno, questo parametro punta al byte immediatamente dopo l'ACL.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione securitybaseapi.h (include Windows.h)
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

GetAce

GetAclInformation

Controllo di accesso di basso livello

Funzioni di Controllo di accesso di basso livello