OleRegEnumVerbs

指定されたクラスに登録された動詞の列挙を提供する。カスタム DLL オブジェクトアプリケーションの開発者は、この関数を使用して既定のオブジェクトハンドラの動作をエミュレートする。

OleRegEnumVerbs clsid, ppenum

clsid : [var] 動詞が要求されるクラス識別子。
ppenum : [var] 新しい列挙オブジェクトへのインターフェイスポインタを受け取る IEnumOLEVERB* ポインタ変数のアドレス。

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

解説

指定されたクラスに登録された動詞の列挙を提供する。カスタム DLL
オブジェクトアプリケーションの開発者は、この関数を使用して既定のオブジェクトハンドラの動作をエミュレートする。

[戻り値]
関数が成功した場合は S_OK を返す。その他に返される値は以下のとおり。
（以下省略）

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

情報