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

Controllo dell’accesso

Funzioni Controllo di accesso di base

BuildTrusteeWithName

BuildTrusteeWithObjectsAndName

BuildTrusteeWithSid

OBJECTS_AND_NAME

ACL specifici dell'oggetto

SE_OBJECT_TYPE

SID

FIDUCIARIO