OleRegGetUserType

指定されたクラスのユーザタイプをレジストリから取得する。

OleRegGetUserType clsid, dwFormOfType, pszUserType

clsid : [var] ユーザタイプが要求されるクラスの CLSID。
dwFormOfType : [int] ユーザに提示する文字列の形式。指定可能な値は USERCLASSTYPE 列挙から取得する。
pszUserType : [var] ユーザタイプを受け取る文字列へのポインタ。

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

解説

指定されたクラスのユーザタイプをレジストリから取得する。

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

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

情報