OleRegGetMiscStatus

指定された CLSID がサポートする表現と動作に関する雑多な情報をレジストリから返す。

OleRegGetMiscStatus clsid, dwAspect, pdwStatus

clsid : [var] 状態情報が要求されるクラスの CLSID。
dwAspect : [int] 情報が要求されるクラスの表示アスペクト。指定可能な値は DVASPECT 列挙から取得する。
pdwStatus : [var] 状態情報を受け取る変数へのポインタ。

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

解説

指定された CLSID がサポートする表現と動作に関する雑多な情報をレジストリから返す。

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

[備考]
オブジェクトアプリケーションは、雑多な状態情報を取得するために OLE に依頼する 2 つの方法のいずれかを使用できる。1 つは
OleRegGetMiscStatus を呼び出す方法である。もう 1 つは、既定のオブジェクトハンドラから
IOleObject::GetMiscStatus が呼び出されたときに OLE_S_USEREG
を返す方法である。OLE_S_USEREG は既定のハンドラに OleRegGetMiscStatus を呼び出すよう指示する。DLL
オブジェクトアプリケーションは OLE_S_USEREG を返せないため、オブジェクトハンドラに作業を委譲するのではなく
OleRegGetMiscStatus を呼び出さなければならない。
OleRegGetMiscStatus とその兄弟関数である
OleRegGetUserType、OleRegEnumFormatEtc、OleRegEnumVerbs は、カスタム DLL
オブジェクトアプリケーションの開発者が、レジストリからオブジェクトに関する情報を取得する際の OLE
の既定のオブジェクトハンドラの動作をエミュレートする方法を提供する。これらの関数を使用することで、独自に書く相当な労力と、レジストリで直接作業することの落とし穴を避けることができる。さらに、これらの関数の今後の拡張や最適化を、自分でコーディングすることなく得られる。

情報