Funzione SetEnvironmentVariableA (processenv.h)
Imposta il contenuto della variabile di ambiente specificata per il processo corrente.
Sintassi
BOOL SetEnvironmentVariableA(
[in] LPCSTR lpName,
[in, optional] LPCSTR 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.
Nota
L'intestazione processenv.h definisce SetEnvironmentVariable come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |