Funzione ExpandEnvironmentStringsForUserA (userenv.h)
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 |