Funzione SetEnvironmentVariable (winbase.h)
Imposta il contenuto della variabile di ambiente specificata per il processo corrente.
Sintassi
BOOL SetEnvironmentVariable(
[in] LPCTSTR lpName,
[in, optional] LPCTSTR lpValue
);
Parametri
[in] lpName
Nome della variabile di ambiente. Il sistema operativo crea la variabile di ambiente se non esiste e lpValue non è NULL.
[in, optional] lpValue
Contenuto della variabile di ambiente. La dimensione massima di una variabile di ambiente definita dall'utente è di 32.767 caratteri. Per altre informazioni, vedere Variabili di ambiente.
Windows Server 2003 e Windows XP: Le dimensioni totali del blocco di ambiente per un processo potrebbero non superare i 32.767 caratteri.
Se questo parametro è NULL, la variabile viene eliminata dall'ambiente del processo corrente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Questa funzione non ha alcun effetto sulle variabili di ambiente di sistema o sulle variabili di ambiente di altri processi.
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 | winbase.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 |