Funzione BuildTrusteeWithNameA (aclapi.h)

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

Sintassi

void BuildTrusteeWithNameA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] LPSTR      pName
);

Parametri

[in, out] pTrustee

Puntatore a una struttura TRUSTEE da 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 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

Panoramica di Controllo di accesso

Funzioni Controllo di accesso di base

BuildTrusteeWithObjectsAndName

BuildTrusteeWithObjectsAndSid

BuildTrusteeWithSid

FIDUCIARIO