CommandLineToArgvW
The CommandLineToArgvW
function parses a wide-character Unicode command-line string. It returns a
pointer to a set of wide-character Unicode argument strings and a count of
arguments, similar to the standard C run-time argv and argc
values. The function provides a way to obtain a Unicode set of argv and argc
values from a Unicode command-line string.
LPWSTR *
CommandLineToArgvW(
|
LPCWSTR lpCmdLine, |
// pointer to a
command-line string |
|
int *pNumArgs |
// pointer to a
variable that receives the argument count |
|
); |
|
Parameters
lpCmdLine
Pointer to a
null-terminated Unicode command-line string. An application will usually
directly pass on the value returned by a call to GetCommandLineW.
*pNumArgs
Pointer to an
integer variable that the function sets to the count of arguments parsed.
Return Values
If the
function succeeds, the return value is a non-NULL pointer to the constructed
argument list, which is a set of Unicode wide-character argument strings.
If the
function fails, the return value is NULL. To get extended error information,
call GetLastError.
Remarks
It is the
caller s responsibility to free the memory used by the argument list when it is
no longer needed. To free the memory, use a single call to either the GlobalFree
or LocalFree function.
See Also