Freigeben über


SetEnvironmentVariable-Funktion (winbase.h)

Legt den Inhalt der angegebenen Umgebungsvariablen für den aktuellen Prozess fest.

Syntax

BOOL SetEnvironmentVariable(
  [in]           LPCTSTR lpName,
  [in, optional] LPCTSTR lpValue
);

Parameter

[in] lpName

Der Name der Umgebungsvariablen. Das Betriebssystem erstellt die Umgebungsvariable, wenn sie nicht vorhanden ist und lpValue nicht NULL ist.

[in, optional] lpValue

Der Inhalt der Umgebungsvariablen. Die maximale Größe einer benutzerdefinierten Umgebungsvariable beträgt 32.767 Zeichen. Weitere Informationen finden Sie unter Umgebungsvariablen.

Windows Server 2003 und Windows XP: Die Gesamtgröße des Umgebungsblocks für einen Prozess darf 32.767 Zeichen nicht überschreiten.

Wenn dieser Parameter NULL ist, wird die Variable aus der Umgebung des aktuellen Prozesses gelöscht.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion hat keine Auswirkungen auf die Systemumgebungsvariablen oder die Umgebungsvariablen anderer Prozesse.

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 winbase.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

Getenvironmentvariable