通过

SHGetRealIDL 函数 (shlobj_core.h)

  • 项目

[SHGetRealIDL 可在“要求”部分指定的操作系统中使用。 它在后续版本中可能已更改或不可用。]

将指向项标识符列表的简单指针 (PIDL) 转换为完整的 PIDL。

语法

SHSTDAPI SHGetRealIDL(
  [in]  IShellFolder    *psf,
  [in]  PCUITEMID_CHILD pidlSimple,
  [out] PITEMID_CHILD   *ppidlReal
);

参数

[in] psf

类型： IShellFolder*

指向要转换其简单 PIDL 的 IShellFolder 实例的指针。

[in] pidlSimple

类型： PCUITEMID_CHILD

要转换的简单 PIDL。

[out] ppidlReal

类型： PITEMID_CHILD*

此方法返回时，包含指向完全转换的 PIDL 的指针。 如果函数失败，此参数将设置为 NULL。

返回值

类型： HRESULT

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

要求

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