SHCreateItemFromRelativeName 函数（shobjidl_core.h）

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

Syntax

SHSTDAPI SHCreateItemFromRelativeName(
  [in]  IShellItem *psiParent,
  [in]  PCWSTR     pszName,
  [in]  IBindCtx   *pbc,
  [in]  REFIID     riid,
  [out] void       **ppv
);

参数

[in] psiParent

类型： IShellItem*

指向父 Shell 项的指针。

[in] pszName

类型：PCWSTR

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定相对于 psiParent 的显示名称。

[in] pbc

类型： IBindCtx*

指向控制分析作的绑定上下文的指针。 此参数可以为 NULL。

[in] riid

类型： REFIID

对接口 ID 的引用。

[out] ppv

类型： void**

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

返回值

类型：HRESULT

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

要求