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_IShellItemIID_IShellItem2

[out] ppv

类型: void**

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

返回值

类型: HRESULT

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

注解

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

要求

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