Funzione FreeEnvironmentStringsA (processenv.h)

Articolo
11/12/2024

Libera un blocco di stringhe di ambiente.

Sintassi

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

Parametri

penv

Puntatore a un blocco di stringhe di ambiente. Il puntatore al blocco deve essere ottenuto chiamando la funzione GetEnvironmentStrings .

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

Osservazioni

Se è stata usata la versione ANSI di funzione GetEnvironmentStrings, assicurarsi di usare la versione ANSI di FreeEnvironmentStrings. Analogamente, se è stata usata la versione Unicode di GetEnvironmentStrings, assicurarsi di usare la versione Unicode di FreeEnvironmentStrings.

Esempi

Per un esempio, vedere Modifica delle variabili di ambiente.

Nota

L'intestazione processenv.h definisce FreeEnvironmentStrings 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 che 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

Condividi tramite