Funzione BuildTrusteeWithObjectsAndSidA (aclapi.h)

Articolo
03/05/2024

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