Funzione BuildTrusteeWithSidA (aclapi.h)

Articolo
02/23/2024

La funzione BuildTrusteeWithSid inizializza una struttura TRUSTEEE . Il chiamante specifica l'identificatore di sicurezza (SID) del trustee. La funzione imposta altri membri della struttura su valori predefiniti e non cerca il nome associato al SID.

Sintassi

void BuildTrusteeWithSidA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] PSID       pSid
);

Parametri

[in, out] pTrustee

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

[in, optional] pSid

Puntatore a una struttura SID che identifica l'attendibilità. La funzione BuildTrusteeWithSid assegna questo puntatore al membro ptstrName della struttura TRUSTEE . La funzione imposta gli altri membri della struttura TRUSTEE come indicato di seguito.

Valore	Significato
pMultipleTrustee	NULL
MultipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
TrusteeForm	TRUSTEE_IS_SID
TrusteeType	TRUSTEE_IS_UNKNOWN

Valore restituito

nessuno

Osservazioni

Nota

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