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 |