Funzione ExpandEnvironmentStringsForUserA (userenv.h)

Articolo
11/20/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 dalLogonUser , CreateRestrictedToken, DuplicateToken, OpenProcessTokeno funzione 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 Access Rights for Access-Token Objects.

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 di lpDest, in TCHARs.

Valore restituito

Tipo: bool

true se ha esito positivo; in caso contrario, FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Di seguito è riportata una stringa di origine di esempio:

%USERPROFILE%\ntuser.dat

Quando ExpandEnvironmentStringsForUser restituisce, la stringa di destinazione si espande come segue:

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 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 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	userenv.h
libreria	Userenv.lib
dll	Userenv.dll

Vedere anche

Panoramica dei profili utente

riferimento ai profili utente

Condividi tramite