DPA_SaveStream関数 (dpa_dsa.h)

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

ヘッダーを書き出し、指定したコールバック関数を呼び出して各要素を書き込むことで、動的ポインター配列 (DPA) をストリームに保存します。

構文

HRESULT DPA_SaveStream(
  [in] HDPA         hdpa,
  [in] PFNDPASTREAM pfn,
  [in] IStream      *pstream,
  [in] void         *pvInstData
);

[in] hdpa

種類: HDPA

DPA へのハンドルを受け取ります。

[in] pfn

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

[in] pstream

種類: IStream*

IStream オブジェクト。

[in] pvInstData

型: void*

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

型: HRESULT

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

リターンコード	説明
S_OK	コールバック関数が要素の保存に失敗したことを示します。ただし、プロセスは続行する必要があります。
S_FALSE	コールバックが失敗した場合でも、プロセスが中断されなかったことを示します。
E_INVALIDARG	1 つ以上のパラメーターが無効であることを示します。

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

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