Retrieves the command-line string for the current process.
Syntax
LPTSTR WINAPI GetCommandLine(void);
Parameters
This function has no parameters.
Return Value
The return value is a pointer to the command-line string for the current process.
Remarks
ANSI console processes written in C can use the argc and argv arguments of the main function to access the command-line arguments. ANSI GUI applications can use the lpCmdLine parameter of the WinMain function to access the command-line string, excluding the program name. The main and WinMain functions cannot return Unicode strings.
Unicode console process written in C can use the wmain or _tmain function to access the command-line arguments. Unicode GUI applications must use the
GetCommandLineW function to access Unicode strings.
To convert the command line to an argv style array of strings, call the
CommandLineToArgvW function.
Note The name of the executable in the command line that the operating system provides to a process is not necessarily identical to that in the command line that the calling process gives to the
CreateProcess function. The operating system may prepend a fully qualified path to an executable name that is provided without a fully qualified path.
Requirements
| Minimum supported client | Windows 2000 Professional |
| Minimum supported server | Windows 2000 Server |
| Header | Winbase.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |
| Unicode and ANSI names | GetCommandLineW (Unicode) and GetCommandLineA (ANSI) |
See Also
- CreateProcess
- Process and Thread Functions
Send comments about this topic to Microsoft
Build date: 11/19/2009