Funzione BuildTrusteeWithNameW (aclapi.h)

La funzione BuildTrusteeWithName inizializza una struttura TRUSTEE . Il chiamante specifica il nome del trustee. La funzione imposta altri membri della struttura su valori predefiniti.

Sintassi

void BuildTrusteeWithNameW(
  [in, out]      PTRUSTEE_W pTrustee,
  [in, optional] LPWSTR     pName
);

Parametri

[in, out] pTrustee

Puntatore a una struttura TRUSTEE per inizializzare. La funzione BuildTrusteeWithName non alloca memoria. Se questo parametro è NULL o un puntatore non valido, i risultati non sono definiti.

[in, optional] pName

Puntatore a una stringa con terminazione null contenente il nome del trustee per il membro ptstrName della struttura TRUSTEE . La funzione BuildTrusteeWithName imposta gli altri membri della struttura TRUSTEE come indicato di seguito.

Valore Significato
pMultipleTrustee
NULL
MultipleTrusteeOperation
NO_MULTIPLE_TRUSTEE
TrusteeForm
TRUSTEE_IS_NAME
TrusteeType
TRUSTEE_IS_UNKNOWN

Valore restituito

nessuno

Osservazioni

Nota

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

Funzioni di base Controllo di accesso

BuildTrusteeWithObjectsAndName

BuildTrusteeWithObjectsAndSid

BuildTrusteeWithSid

FIDUCIARIO