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)
程式庫 Shell32.lib
Dll Shell32.dll (5.0 版或更新版本)
API 集合 ext-ms-win-shell32-l1-2-2 (於 Windows 10 10.0.14393 版中引進)