COleControl::ExchangeVersion

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

コントロールのバージョン情報の状態をシリアル化または初期化します。

BOOL ExchangeVersion(
   CPropExchange* pPX,
   DWORD dwVersionDefault,
   BOOL bConvert = TRUE 
);

パラメータ

pPX
CPropExchange オブジェクトへのポインタ。交換方向などのプロパティ交換のコンテキストを確立するために、フレームワークに用意されているオブジェクト。
dwVersionDefault
コントロールの現在のバージョン番号。
bConvert
保存するときに保存データを最新の形式に変換するか、または読み込まれたときと同じ形式を維持するかを示します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

通常、コントロールでオーバーライドした COleControl::DoPropExchange から呼び出される最初の関数になります。読み込み時に保存データからバージョン番号を読み込み、それに応じて CPropExchange オブジェクトのバージョン属性を設定します。保存時には、保存データのバージョン番号を書き込みます。

保存とバージョン決定の詳細については、「MFC ActiveX コントロール : シリアル化」を参照してください。