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 |