Funzione GetEnvironmentStringsW (processenv.h)

Recupera le variabili di ambiente per il processo corrente.

Sintassi

LPWCH GetEnvironmentStringsW();

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore al blocco di ambiente del processo corrente.

Se la funzione ha esito negativo, il valore restituito è NULL.

Osservazioni

La funzione GetEnvironmentStrings restituisce un puntatore a un blocco di memoria contenente le variabili di ambiente del processo chiamante (sia il sistema che le variabili di ambiente utente). Ogni blocco di ambiente contiene le variabili di ambiente nel formato seguente:

Var1=Value1\0
Var2=Value2\0
Var3=Value3\0
...
valore=VarN\0\0

Il nome di una variabile di ambiente non può includere un segno di uguale (=).

Considera questa memoria come di sola lettura; non modificarlo direttamente. Per aggiungere o modificare una variabile di ambiente, usare le funzioni di GetEnvironmentVariable GetEnvironmentVariable e SetEnvironmentVariable.

Quando il blocco restituito da GetEnvironmentStrings non è più necessario, deve essere liberato chiamando la funzione FreeEnvironmentStrings.

Si noti che la versione ANSI di questa funzione, GetEnvironmentStringsA, restituisce caratteri OEM.

Esempi

Per un esempio, vedere Modifica delle variabili di ambiente.

Nota

L'intestazione processenv.h definisce GetEnvironmentStrings 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 [app desktop | App UWP]
server minimo supportato	Windows Server 2003 [app desktop | App UWP]
piattaforma di destinazione	Finestre
intestazione	processenv.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

variabili di ambiente

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable