Funzione GetEnvironmentStrings (processenv.h)
Recupera le variabili di ambiente per il processo corrente.
Sintassi
LPCH GetEnvironmentStrings();
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.
Commenti
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=Valore1\0
Var2=Valore2\0
Var3=Valore3\0
...
VarN=ValueN\0\0
Il nome di una variabile di ambiente non può includere un segno di uguale (=).
Trattare questa memoria come di sola lettura; non modificarla direttamente. Per aggiungere o modificare una variabile di ambiente, usare le funzioni 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 i caratteri OEM.
Esempio
Per un esempio, vedere Modifica delle variabili di ambiente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | processenv.h (includono Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |