FreeEnvironmentStringsA-Funktion (processenv.h)

Gibt einen Block von Umgebungszeichenfolgen frei.

Syntax

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

Parameter

penv

Ein Zeiger auf einen Block von Umgebungszeichenfolgen. Der Zeiger auf den Block muss durch Aufrufen der GetEnvironmentStrings-Funktion abgerufen werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Wenn Sie die ANSI-Version von GetEnvironmentStrings verwendet haben, sollten Sie unbedingt die ANSI-Version von FreeEnvironmentStrings verwenden. Wenn Sie die Unicode-Version von GetEnvironmentStrings verwendet haben, sollten Sie auch die Unicode-Version von FreeEnvironmentStrings verwenden.

Beispiele

Ein Beispiel finden Sie unter Ändern von Umgebungsvariablen.

Hinweis

Der processenv.h-Header definiert FreeEnvironmentStrings als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile processenv.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Umgebungsvariablen

GetEnvironmentStrings