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 関数の呼び出しと同じ結果が生成されます。

要件

こちらもご覧ください

CLSCTX

Cocreateinstance