OleGetAutoConvert

指定された CLSID のオブジェクトが別の CLSID に自動変換されるようにレジストリが設定されているかを判定し、設定されている場合は新しい CLSID を取得する。

OleGetAutoConvert clsidOld, pClsidNew

clsidOld : [var] オブジェクトの CLSID。
pClsidNew : [var] 新しい CLSID を受け取る変数へのポインタ。clsidOld に対する自動変換がレジストリに設定されていない場合、clsidOld が返される。pClsidNew パラメータが NULL になることはない。

(プラグイン / モジュール : ole32.dll)

解説

指定された CLSID のオブジェクトが別の CLSID
に自動変換されるようにレジストリが設定されているかを判定し、設定されている場合は新しい CLSID を取得する。

[戻り値]
この関数は標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED
に加えて、以下の値を返すことがある。
（以下省略）

[備考]
OleGetAutoConvert は、指定されたオブジェクトに対するレジストリ内の AutoConvertTo
エントリを返す。AutoConvertTo サブキーは、指定された CLSID のオブジェクトを新しい CLSID
に自動変換するかどうかを指定する。これは通常、古いバージョンのアプリケーションで作成されたファイルを現在のバージョンに変換するために使用される。AutoConvertTo
エントリがない場合、この関数は clsidOld の値を返す。OleDoAutoConvert 関数は OleGetAutoConvert
を呼び出して指定されたオブジェクトを変換すべきかどうかを判定する。オブジェクト変換をサポートするコンテナアプリケーションは、オブジェクトをロードするたびに
OleDoAutoConvert を呼び出すべきである。コンテナが OleLoad ヘルパー関数を使用する場合は、OleLoad
が内部で呼び出すため明示的に OleDoAutoConvert
を呼び出す必要はない。指定したクラスの自動変換を設定するには、OleSetAutoConvert
関数を呼び出すことができる（通常はアプリケーションインストールのセットアッププログラム内で）。この関数は AutoConvertTo
サブキーを使用してオブジェクトクラスを別のオブジェクトクラスへの自動変換のためにタグ付けする。これは CLSID キーのサブキーである。

情報