Функция PathProcessCommand (shlobj.h)

Статья
08/26/2023

Не рекомендуется. Обрабатывает строку, содержащую командную строку, и создает подходящую строку в кавычках с вложенными аргументами, если это необходимо.

Синтаксис

LONG PathProcessCommand(
  [in]  PCWSTR pszSrc,
  [out] PWSTR  pszDest,
        int    cchDest,
        DWORD  dwFlags
);

Параметры

[in] pszSrc

Тип: PCWSTR

Указатель на строку, завершающуюся значением NULL, которая содержит командную строку для обработки.

[out] pszDest

Тип: PWSTR

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

cchDest

Тип: int

Максимальное число символов, которое можно поместить в pszDest, не включая завершающий пустой символ. Если это значение слишком мало, функция завершается ошибкой.

dwFlags

Тип: DWORD

Флаги, управляющие процедурой. Одно или несколько из следующих значений:

PPCF_ADDQUOTES (0x00000001)

Добавьте кавычки, если они требуются для пути.

PPCF_ADDARGUMENTS (0x00000003)

Добавьте конечные аргументы в выходную строку. Это значение включает PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

Не сопоставляйте входную строку с папками, а только для файлов.

PPCF_FORCEQUALIFY (0x00000040)

Квалифицируйте даже несмежественные имена файлов.

PPCF_LONGESTPOSSIBLE (0x00000080)

Всегда выбирайте максимально длинное имя исполняемого файла.

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

Тип: LONG

В случае успешного выполнения возвращает положительное значение. Если lpDest имеет значение NULL, функция возвращает требуемый размер буфера в символах, включая завершающий символ NULL. Если вызов завершается сбоем, функция возвращает отрицательное значение.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj.h
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)

Поделиться через