SHCreateItemFromRelativeName 函数 (shobjidl_core.h)

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

语法

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 错误代码。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)
DLL	Shell32.dll
API 集	ext-ms-win-shell-shell32-l1-2-2 (在 Windows 10 版本 10.0.14393 中引入)