Функция CommandLineToArgvW


Функция CommandLineToArgvW подробно анализирует командную строку Уникода. Она возвращает указатель на строки параметров набора шрифта Unicode и количество параметров, похожих на стандартные значения argv и argc Cи времени выполнения. Функция предусматривает способ получить установленные значения argv и argc Уникода из командной строки Уникода.

Синтаксис

LPWSTR * CommandLineToArgvW(
  LPCWSTR lpCmdLine,  // указатель на командную строку
  int * pNumArgs      // принимает подсчет параметров
);

Параметры

lpCmdLine

[in] Указатель на командную строку Уникода с нулевым символом в конце. Приложение обычно непосредственно будет передавать значение, возвращенное вызовом к функции GetCommandLineW.

Если этот параметр - пустая строка, " ", функция возвращает путь к текущему исполняемому файлу.

pNumArgs

[out] Указатель на целую переменную, которая принимает подсчет подробно анализируемых параметров.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение – ненулевой (непустой) указатель на созданный список параметров, который является массивом строк Уникода.

Если функция завершается с ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получать дополнительные данные об ошибках, вызовите GetLastError.

Замечания

Здесь вызывающая программа ответственна за освобождение памяти, которая используется списком параметров, когда он больше не нужен. Чтобы освободить память, используйте одиночный вызов функции GlobalFree.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, GetCommandLine, GlobalFree

Размещение и совместимость CommandLineToArgvW

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и старше

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Shell32.lib

Заголовочный файл

 

- объявлено в

Shellapi.h

- включено в

Windows.h

Unicode

Реализуется только в Unicode

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz