Share via

GetCommandLineW-Funktion (processenv.h)

  • Artikel

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.

Hinweise

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 argv der funktionen Standard oder wmain verwenden, indem sie diese als Programmeinstiegspunkt 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 Array von Zeichenfolgen im Argv-Stil 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 Namen in der Befehlszeile identisch, die der aufrufende Prozess der CreateProcess-Funktion bereitstellt. Das Betriebssystem kann einem ausführbaren Namen, der ohne vollqualifizierten Pfad bereitgestellt wird, einen vollqualifizierten Pfad voranstellen.
 

Hinweis

Der header processenv.h 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 nicht codierungsneutralem Code 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
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 (einschließlich 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

CreateProcess

Prozess- und Threadfunktionen