GetEnvironmentStringsW-Funktion (processenv.h)
Ruft die Umgebungsvariablen für den aktuellen Prozess ab.
Syntax
LPWCH GetEnvironmentStringsW();
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf den Umgebungsblock des aktuellen Prozesses.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL.
Bemerkungen
Die GetEnvironmentStrings--Funktion gibt einen Zeiger auf einen Speicherblock zurück, der die Umgebungsvariablen des aufrufenden Prozesses (sowohl das System als auch die Benutzerumgebungsvariablen) enthält. Jeder Umgebungsblock enthält die Umgebungsvariablen im folgenden Format:
Var1=Wert1\0
Var2=Wert2\0
Var3=Wert3\0
...
VarN=ValueN\0\0
Der Name einer Umgebungsvariable darf kein Gleichheitszeichen (=) enthalten.
Behandeln Sie diesen Speicher als schreibgeschützt; sie nicht direkt ändern. Verwenden Sie zum Hinzufügen oder Ändern einer Umgebungsvariablen die GetEnvironmentVariable- und SetEnvironmentVariable--Funktionen.
Wenn der von GetEnvironmentStrings zurückgegebene Block nicht mehr benötigt wird, sollte er durch Aufrufen der funktion FreeEnvironmentStrings freigegeben werden.
Beachten Sie, dass die ANSI-Version dieser Funktion, GetEnvironmentStringsA, OEM-Zeichen zurückgibt.
Beispiele
Ein Beispiel finden Sie unter Ändern von Umgebungsvariablen.
Anmerkung
Der processenv.h-Header definiert GetEnvironmentStrings 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 |