OleCreateDefaultHandler 関数 (ole2.h)
既定の埋め込みハンドラーの新しいインスタンスを作成します。 このインスタンスは初期化されるため、埋め込みオブジェクトが実行中の状態になったときにローカル サーバーが作成されます。
構文
HRESULT OleCreateDefaultHandler(
[in] REFCLSID clsid,
[in] LPUNKNOWN pUnkOuter,
[in] REFIID riid,
[out] LPVOID *lplpObj
);
パラメーター
[in] clsid
埋め込みオブジェクトが実行状態になったときに読み込まれる OLE サーバーを識別する CLSID。
[in] pUnkOuter
ハンドラーを集計する場合は、制御する IUnknown インターフェイスへのポインター。集計しない場合は NULL 。
[in] riid
呼び出し元がハンドラーと通信するインターフェイスの識別子 (通常はIID_IOleObject) への参照。
[out] lplpObj
riid で要求されたインターフェイス ポインターを受け取るポインター変数のアドレス。 正常に戻ると、*ppvObj には、新しく作成されたハンドラーで要求されたインターフェイス ポインターが含まれます。
戻り値
この関数は成功した場合に NOERROR を返し、標準の戻り値E_OUTOFMEMORYをサポートします。
注釈
OleCreateDefaultHandler は、既定の埋め込みハンドラーの新しいインスタンスを作成し、埋め込みオブジェクトが実行状態になったときに clsid パラメーターで識別されるローカル サーバーを作成するように初期化します。 ハンドラーを記述していて、既定のハンドラーのサービスを使用する場合は、 OleCreateDefaultHandler を呼び出します。 OLE は、オブジェクト作成呼び出しで指定された CLSID が登録されていない場合にも内部的に呼び出します。
指定されたクラスに特別なハンドラーがない場合、 OleCreateDefaultHandler を呼び出すと、値がCLSCTX_INPROC_HANDLER割り当てられたクラス コンテキスト パラメーターを使用した CoCreateInstance 関数の呼び出しと同じ結果が生成されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ole2.h |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |