GetCommandLineW-Funktion (processenv.h)

Ruft die Befehlszeilenzeichenfolge für den aktuellen Prozess ab.

Syntax

LPWSTR GetCommandLineW();

Rückgabewert

Der Rückgabewert ist ein Zeiger auf die Befehlszeilenzeichenfolge für den aktuellen Prozess.

Bemerkungen

Die Lebensdauer des zurückgegebenen Werts wird vom System verwaltet, Anwendungen sollten diesen Wert nicht freigeben oder ändern.

Konsolenprozesse können die argumente argc und argumentieren argumente der haupt- oder wmain funktionen verwenden, indem sie diese als Einstiegspunkt des Programms implementieren. GUI-Prozesse können das lpCmdLine--Argument der WinMain-- oder wWinMain-Funktionen verwenden, indem sie diese als Programmeinstiegspunkt implementieren.

Um die Befehlszeile in ein argv Stylearray von Zeichenfolgen zu konvertieren, übergeben Sie das Ergebnis von GetCommandLineW an CommandLineToArgvW.

Hinweis Der Name der ausführbaren Datei in der Befehlszeile, die das Betriebssystem für einen Prozess bereitstellt, ist nicht unbedingt mit dem in der Befehlszeile identisch, die der aufrufende Prozess der CreateProcess-Funktion bereitstellt. Das Betriebssystem kann einen vollqualifizierten Pfad zu einem ausführbaren Namen vorangestellt haben, der ohne vollqualifizierten Pfad bereitgestellt wird.

 

Anmerkung

Der processenv.h-Header definiert GetCommandLine 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

Siehe auch

CreateProcess-

Prozess- und Threadfunktionen