CIDLData_CreateFromIDArray函式 (shlobj_core.h)

[CIDLData_CreateFromIDArray 可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]

使用預設 vtable 指標建立資料物件。

語法

SHSTDAPI CIDLData_CreateFromIDArray(
  [in]  PCIDLIST_ABSOLUTE        pidlFolder,
  [in]  UINT                     cidl,
  [in]  PCUIDLIST_RELATIVE_ARRAY apidl,
  [out] IDataObject              **ppdtobj
);

參數

[in] pidlFolder

類型： PCIDLIST_ABSOLUTE

apidl 中所指定專案根目錄的完整 IDLIST。

[in] cidl

類型： UINT

apidl 陣列中的項目數。

[in] apidl

類型： PCUIDLIST_RELATIVE_ARRAY

相對於 pidlFolder 的項目標識子陣列。 一般而言， apidl 是子標識符的陣列， 而 pidlFolder 是這些專案的完整 PIDL。 不過， pidlFolder 可以是 null PIDL (桌面 IDLIST) 。 在此情況下， apidl 可以包含完整標識符清單。

[out] ppdtobj

類型： IDataObject**

實作 IDataObject 之物件的指標位址。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此函式所建立的數據物件會提供殼層剪貼簿格式標識碼 CFSTR_SHELLIDLIST。 此數據物件也支援 IDataObject：：SetData 呼叫，以挑選其他剪貼簿格式。

規格需求

另請參閱

SHCreateDataObject