Funzione BuildExplicitAccessWithNameA (aclapi.h)
La funzione BuildExplicitAccessWithName inizializza una struttura EXPLICIT_ACCESS con dati specificati dal chiamante. Il trustee è identificato da una stringa di nome.
Sintassi
void BuildExplicitAccessWithNameA(
[in, out] PEXPLICIT_ACCESS_A pExplicitAccess,
[in, optional] LPSTR pTrusteeName,
[in] DWORD AccessPermissions,
[in] ACCESS_MODE AccessMode,
[in] DWORD Inheritance
);
Parametri
[in, out] pExplicitAccess
Puntatore a una struttura EXPLICIT_ACCESS da inizializzare. La funzione BuildExplicitAccessWithName non alloca alcuna memoria. Questo parametro non può essere NULL.
[in, optional] pTrusteeName
Puntatore a una stringa con terminazione null contenente il nome del trustee per il membro ptstrName della struttura TRUSTEE . La funzione BuildExplicitAccessWithName imposta gli altri membri della struttura TRUSTEE come indicato di seguito.
Valore | Significato |
---|---|
|
NULL |
|
NO_MULTIPLE_TRUSTEE |
|
TRUSTEE_IS_NAME |
|
TRUSTEE_IS_UNKNOWN |
[in] AccessPermissions
Specifica una maschera di accesso per il membro grfAccessPermissions della struttura EXPLICIT_ACCESS . La maschera è un set di flag di bit che usano il formato ACCESS_MASK per specificare i diritti di accesso che un ACE consente, nega o controlla per il truste. Le funzioni che usano la struttura di EXPLICIT_ACCESS non convertono, interpretano o convalidano i bit in questa maschera.
[in] AccessMode
Specifica una modalità di accesso per il membro grfAccessMode della struttura EXPLICIT_ACCESS . La modalità di accesso indica se la voce di controllo di accesso (ACE) consente, nega o controlla i diritti specificati. Per un elenco di controllo di accesso discrezionale (DACL), questo parametro può essere uno dei valori dell'enumerazione ACCESS_MODE . Per un elenco di controllo di accesso del sistema (SACL), questo parametro può essere una combinazione di valori ACCESS_MODE .
[in] Inheritance
Specifica un tipo di ereditarietà per il membro grfInheritance della struttura EXPLICIT_ACCESS . Questo valore è un set di flag di bit che determinano se altri contenitori o oggetti possono ereditare l'ACE dall'oggetto primario a cui è collegato l'ACL . Il valore di questo membro corrisponde alla parte di ereditarietà (byte a basso ordine) del membro AceFlags della struttura ACE_HEADER . Questo parametro può essere NO_INHERITANCE per indicare che l'ACE non è ereditabile oppure può essere una combinazione dei valori seguenti.
Valore restituito
nessuno
Osservazioni
Nota
L'intestazione aclapi.h definisce BuildExplicitAccessWithName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 | aclapi.h |
Libreria | Advapi32.lib |
DLL | Advapi32.dll |
Vedi anche
Panoramica Controllo di accesso