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, um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastErrorauf.
Bemerkungen
Wenn Sie die ANSI-Version von GetEnvironmentStrings Funktion verwendet haben, müssen Sie unbedingt die ANSI-Version von FreeEnvironmentStringsverwenden. Wenn Sie auch die Unicode-Version von GetEnvironmentStringsverwendet haben, müssen Sie unbedingt die Unicode-Version von FreeEnvironmentStringsverwenden.
Beispiele
Ein Beispiel finden Sie unter Ändern von Umgebungsvariablen.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | processenv.h (include Windows.h on Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |