SHCreateItemFromParsingName 函数 (shobjidl_core.h)

创建并初始化分析名称中的 Shell 项对象。

语法

SHSTDAPI SHCreateItemFromParsingName(
  [in]           PCWSTR   pszPath,
  [in, optional] IBindCtx *pbc,
  [in]           REFIID   riid,
  [out]          void     **ppv
);

参数

[in] pszPath

类型： PCWSTR

指向显示名称的指针。

[in, optional] pbc

类型： IBindCtx*

可选。 指向绑定上下文的指针，用于将参数作为输入和输出传递给分析函数。 这些传递的参数通常特定于数据源，并由数据源所有者记录。 例如，文件系统数据源使用 STR_FILE_SYS_BIND_DATA bind 上下文参数接受 (分析的名称作为WIN32_FIND_DATA结构) 。

可以传递STR_PARSE_PREFER_FOLDER_BROWSING，以指示尽可能使用文件系统数据源分析 URL。 使用 CreateBindCtx 构造绑定上下文对象，并使用 IBindCtx：：RegisterObjectParam 填充值。 有关这些项的完整列表，请参阅 绑定上下文字符串键 。 有关使用此参数的示例，请参阅 使用参数分析示例 。

如果未向分析函数传递或接收任何数据，则此值可以为 NULL。

[in] riid

类型： REFIID

对要通过 ppv 检索的接口的 IID 的引用，通常 IID_IShellItem 或 IID_IShellItem2。

[out] ppv

类型： void**

当此方法成功返回时，包含 riid 中请求的接口指针。 这通常是 IShellItem 或 IShellItem2。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏打包 riid 和 ppv 参数。 此宏根据 ppv 中的 值指向的接口提供正确的 IID，这消除了 riid 中可能导致意外结果的编码错误的可能性。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)
DLL	Shell32.dll