PathProcessCommand 函数 (shlobj.h)

  • 项目

已弃用。 处理包含命令行的字符串，并生成带适当引号的字符串，并根据需要附加参数。

语法

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

参数

[in] pszSrc

类型： PCWSTR

指向包含要处理的命令行的以 null 结尾的字符串的指针。

[out] pszDest

类型： PWSTR

指向一个缓冲区的指针，该缓冲区接收一个以 null 结尾的 Unicode 字符串并带有相应引号。 若要确定此缓冲区的大小，请将此参数设置为 NULL。 函数返回所需的缓冲区大小。

cchDest

类型： int

可放入 pszDest 的最大字符数，不包括终止 null 字符。 如果此值太小，函数将失败。

dwFlags

类型：DWORD

控制过程的标志。 以下一个或多个值：

PPCF_ADDQUOTES (0x00000001)

如果路径需要引号，请添加引号。

PPCF_ADDARGUMENTS (0x00000003)

将尾随参数追加到输出字符串。 此值包括 PPCF_ADDQUOTES。

PPCF_NODIRECTORIES (0x00000010)

不要将输入字符串与文件夹匹配，仅匹配文件对象。

PPCF_FORCEQUALIFY (0x00000040)

甚至限定非相对文件名。

PPCF_LONGESTPOSSIBLE (0x00000080)

始终选择可能最长的可执行文件名称。

返回值

类型： LONG

如果成功，则返回正值。 如果 lpDest 设置为 NULL，则该函数返回所需的缓冲区大小（以字符为单位），包括终止 null 字符。 如果调用失败，函数将返回负值。

注解

注意 此函数可通过 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 获得。 Windows Vista 和更高版本的 Windows 不支持它。
 

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj.h
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)