Funzione SetEnvironmentVariableA (processenv.h)

Articolo
11/20/2024

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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Questa funzione non ha alcun effetto sulle variabili di ambiente di sistema o sulle variabili di ambiente di altri processi.

Esempi

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 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

GetEnvironmentVariable

Condividi tramite