SHCreateItemFromParsingName 函数 （shobjidl_core.h）

从分析名称创建和初始化 Shell 项对象。

Syntax

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绑定上下文参数接受要分析的名称（作为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 中编码错误可能导致意外结果的可能性。

要求