Funzione ExpandEnvironmentStringsForUserA (userenv.h)

Articolo
03/09/2024

Espande la stringa di origine usando il blocco di ambiente stabilito per l'utente specificato.

Sintassi

USERENVAPI BOOL ExpandEnvironmentStringsForUserA(
  [in, optional] HANDLE hToken,
  [in]           LPCSTR lpSrc,
  [out]          LPSTR  lpDest,
  [in]           DWORD  dwSize
);

Parametri

[in, optional] hToken

Tipo: HANDLE

Token per l'utente restituito dalla funzione LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken o OpenThreadToken . Il token deve avere accesso TOKEN_IMPERSONATE e TOKEN_QUERY. Inoltre, a partire da Windows 7, anche il token deve avere accesso TOKEN_DUPLICATE. Per altre informazioni, vedere Diritti di accesso per gli oggetti Access-Token.

Se hToken è NULL, il blocco di ambiente contiene solo variabili di sistema.

[in] lpSrc

Tipo: LPCTSTR

Puntatore alla stringa di origine con terminazione Null da espandere.

[out] lpDest

Tipo: LPTSTR

Puntatore a un buffer che riceve le stringhe espanse.

[in] dwSize

Tipo: DWORD

Specifica le dimensioni del buffer lpDest , in TCHAR.

Valore restituito

Tipo: BOOL

TRUE se ha esito positivo; in caso contrario, FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Di seguito è riportata una stringa di origine di esempio:

%USERPROFILE%\ntuser.dat

Quando ExpandEnvironmentStringsForUser restituisce, la stringa di destinazione si espande nel modo seguente:

C:\Documents and Settings\UserName\ntuser.dat

Nota

L'intestazione userenv.h definisce ExpandEnvironmentStringsForUser 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 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	userenv.h
Libreria	Userenv.lib
DLL	Userenv.dll

Vedi anche

Panoramica dei profili utente

Informazioni di riferimento per i profili utente

Share via