DPA_LoadStream関数 (dpa_dsa.h)

[DPA_LoadStream は Windows Vista で使用できます。以降のバージョンでは、変更または使用できない可能性があります。 ]

指定したコールバック関数を呼び出して各要素を読み取ることによって、ストリームから動的ポインター配列 (DPA) を読み込みます。

構文

HRESULT DPA_LoadStream(
  [out] HDPA         *phdpa,
  [in]  PFNDPASTREAM pfn,
  [in]  IStream      *pstream,
  [in]  void         *pvInstData
);

[out] phdpa

種類: HDPA*

DPA へのハンドル。

[in] pfn

コールバック関数。コールバック関数のプロトタイプについては、「 PFNDPASTREAM 」を参照してください。

[in] pstream

種類: IStream*

IStream オブジェクト。

[in] pvInstData

型: void*

コールバックデータへのポインター。 pvInstData はパラメーターとして pfn に渡されます。

型: HRESULT

次のいずれかの値を返します。

リターンコード	説明
S_OK	コールバック関数が成功し、要素が読み込まれたことを示します。
S_FALSE	コールバック関数が要素の読み込みに失敗したことを示します。ただし、プロセスは続行する必要があります。
E_INVALIDARG	1 つ以上のパラメーターが無効であることを示します。
E_FAIL	ストリームオブジェクトを読み取れないことを示します。
E_OUTOFMEMORY	バッファー長が無効であるか、操作を完了するためのメモリが不足しています。

この関数は、ComCtl32.dll から直接呼び出す必要があります。序数は 9 です。

コールバックは、 pvInstData データをストリームに書き込む役割を担います。