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

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

[in] pstream

種類: IStream*

IStream オブジェクト。

[in] pvInstData

型: void*

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

戻り値

型: HRESULT

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

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

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー dpa_dsa.h
[DLL] ComCtl32.dll