Funzione BuildTrusteeWithObjectsAndSidA (aclapi.h)
La funzione BuildTrusteeWithObjectsAndSid inizializza una struttura TRUSTEE con le informazioni ace (Object-Specific Access Control Entry ) e inizializza i membri rimanenti della struttura sui valori predefiniti. Il chiamante specifica anche la struttura SID che rappresenta l'identificatore di sicurezza del trustee.
Sintassi
void BuildTrusteeWithObjectsAndSidA(
[in, out] PTRUSTEE_A pTrustee,
[in, optional] POBJECTS_AND_SID pObjSid,
[in, optional] GUID *pObjectGuid,
[in, optional] GUID *pInheritedObjectGuid,
[in, optional] PSID pSid
);
Parametri
[in, out] pTrustee
Puntatore a una struttura TRUSTEE da inizializzare. La funzione BuildTrusteeWithObjectsAndSid non alloca memoria. Se questo parametro è NULL o un puntatore non valido, i risultati non sono definiti.
[in, optional] pObjSid
Puntatore a una struttura OBJECTS_AND_SID che contiene informazioni sul trustee e sull'oggetto a protezione diretta.
[in, optional] pObjectGuid
Puntatore a una struttura GUID che descrive il GUID ObjectType da aggiungere alla struttura TRUSTEE .
[in, optional] pInheritedObjectGuid
Puntatore a una struttura GUID che descrive il GUID InheritedObjectType da aggiungere alla struttura TRUSTEE .
[in, optional] pSid
Puntatore a una struttura SID che identifica il trustee.
Valore restituito
nessuno
Osservazioni
Questa funzione non alloca memoria per le strutture TRUSTEE e OBJECTS_AND_SID .
Per altre informazioni sugli ACL specifici dell'oggetto, vedere ACL specifici dell'oggetto.
Nota
L'intestazione aclapi.h definisce BuildTrusteeWithObjectsAndSid come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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
Funzioni Controllo di accesso di base