Funzione BuildTrusteeWithObjectsAndNameA (aclapi.h)

Articolo
02/26/2024

La funzione BuildTrusteeWithObjectsAndName inizializza una struttura TRUSTEE con le informazioni di controllo di accesso specifiche dell'oggetto e inizializza i membri rimanenti della struttura in valori predefiniti. Il chiamante specifica anche il nome del trustee.

Sintassi

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

Parametri

[in, out] pTrustee

Puntatore a una struttura TRUSTEE che verrà inizializzata da questa funzione. Se il valore di questo parametro è NULL o un puntatore non valido, i risultati non sono definiti.

[in, optional] pObjName

Puntatore a una struttura OBJECTS_AND_NAME contenente informazioni sull'attendibilità e sull'oggetto a protezione diretta.

[in, optional] ObjectType

Puntatore a un'enumerazione SE_OBJECT_TYPE contenente informazioni sul tipo di oggetto a protezione diretta.

[in, optional] ObjectTypeName

Puntatore a una stringa che specifica il nome corrispondente al GUID ObjectType da aggiungere alla struttura TRUSTEE restituito nel parametro pTrustee . Questa funzione determina il GUID ObjectType corrispondente a questo nome.

[in, optional] InheritedObjectTypeName

Puntatore a una stringa che specifica il nome corrispondente al GUID InheritedObjectType da aggiungere alla struttura TRUSTEE restituito nel parametro pTrustee . Questa funzione determina il GUID InheritedObjectType corrispondente a questo nome.

[in, optional] Name

Puntatore a una stringa che specifica il nome utilizzato per identificare il trustee.

Valore restituito

nessuno

Osservazioni

Questa funzione non alloca memoria per le strutture TRUSTEE e OBJECTS_AND_NAME .

Per altre informazioni sugli ACL specifici dell'oggetto, vedere ACL specifici dell'oggetto.

Nota

L'intestazione aclapi.h definisce BuildTrusteeWithObjectsAndName 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