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 呼び出しもサポートされています。

要件

こちらもご覧ください

SHCreateDataObject