GetCommandLineA-Funktion (processenv.h)

Ruft die Befehlszeilenzeichenfolge für den aktuellen Prozess ab.

Syntax

LPSTR GetCommandLineA();

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 argc- und argv-Argumente der funktionen Standard oder wmain verwenden, indem sie diese als Einstiegspunkt für das Programm implementieren. GUI-Prozesse können das lpCmdLine-Argument der WinMain - oder wWinMain-Funktionen verwenden, indem sie diese als Einstiegspunkt für das Programm implementieren.

Um die Befehlszeile in ein Array von Zeichenfolgen im Argv-Stil zu konvertieren, übergeben Sie das Ergebnis von GetCommandLineA an CommandLineToArgW.

Hinweis Der Name der ausführbaren Datei in der Befehlszeile, die vom Betriebssystem für einen Prozess bereitgestellt wird, 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 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

   
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

CreateProcess

Prozess- und Threadfunktionen