Condividi tramite


Funzione BuildTrusteeWithNameA (aclapi.h)

La funzione BuildTrusteeWithName inizializza una struttura TRUSTEE . Il chiamante specifica il nome del trustee. La funzione imposta gli 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 ptstrName membro della struttura TRUSTEE . La funzione BuildTrusteeWithName imposta gli altri membri della struttura TRUSTEE come indicato di seguito.

Valore Significato
pMultipleTrustee
NULLO
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
piattaforma di destinazione Finestre
intestazione aclapi.h
libreria Advapi32.lib
dll Advapi32.dll

Vedere anche

Panoramica del controllo di accesso

funzioni di controllo di accesso di base

BuildTrusteeWithObjectsAndName

BuildTrusteeWithObjectsAndSid

BuildTrusteeWithSid

TRUSTEE