GetEnvironmentStrings-Funktion (processenv.h)

Ruft die Umgebungsvariablen für den aktuellen Prozess ab.

Syntax

LPCH GetEnvironmentStrings();

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf den Umgebungsblock des aktuellen Prozesses.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Die GetEnvironmentStrings-Funktion gibt einen Zeiger auf einen Speicherblock zurück, der die Umgebungsvariablen des aufrufenden Prozesses (sowohl die 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 Umgebungsvariablen darf kein Gleichheitszeichen (=) enthalten.

Behandeln Sie diesen Speicher als schreibgeschützt. sie nicht direkt ändern. Um eine Umgebungsvariable hinzuzufügen oder zu ändern, verwenden Sie die Funktionen GetEnvironmentVariable und SetEnvironmentVariable .

Wenn der von GetEnvironmentStrings zurückgegebene Block nicht mehr benötigt wird, sollte er durch Aufrufen der FreeEnvironmentStrings-Funktion freigegeben werden.

Beachten Sie, dass die ANSI-Version dieser Funktion GetEnvironmentStringsA OEM-Zeichen zurückgibt.

Beispiele

Ein Beispiel finden Sie unter Ändern von Umgebungsvariablen.

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

FreeEnvironmentStrings

Getenvironmentvariable

Setenvironmentvariable