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 に対する項目 ID の配列。 通常、 apidl は子 ID の配列であり、 pidlFolder はこれらの項目の完全な PIDL です。 ただし、 pidlFolder には null PIDL (デスクトップ IDLIST) を指定できます。 その場合、 apidl には完全修飾 ID リストを含めることができます。

[out] ppdtobj

型: IDataObject**

IDataObject を実装するオブジェクトへのポインターへのアドレス。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数によって作成されたデータ オブジェクトは、シェルクリップボード形式識別子 CFSTR_SHELLIDLISTを提供します。 このデータ オブジェクトでは、他のクリップボード形式を取得するための IDataObject::SetData 呼び出しもサポートされています。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)
API セット	ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入)

こちらもご覧ください

SHCreateDataObject