AfxOleInit

更新 : 2007 年 11 月

アプリケーションの OLE サポートを初期化します。

BOOL AFXAPI AfxOleInit( );

戻り値

正常終了した場合は 0 以外を返します。初期化に失敗した場合は 0 を返します。この場合、不正なバージョンの OLE システム DLL がインストールされている可能性があります。

解説

MFC アプリケーションの OLE サポートを初期化するために呼び出します。関数を呼び出すと、次のアクションが発生します。

• 呼び出すアプリケーションの現在のアパートメントにある COM (Component Object Model) ライブラリを初期化します。詳細については、「OleInitialize」を参照してください。

• IMessageFilter インターフェイスを実装して、メッセージ フィルタ オブジェクトを作成します。AfxOleGetMessageFilter を呼び出すと、このメッセージ フィルタにアクセスできます。

メモ :
AfxOleInit を MFC DLL で呼び出すと、呼び出しは失敗します。これは、関数が DLL から呼び出された場合、呼び出したアプリケーションが既に OLE システムを初期化していると想定するためです。

メモ :
MFC アプリケーションは、シングル スレッド アパートメント (STA: Single-Threaded Apartment) として初期化する必要があります。InitInstance のオーバーライドで CoInitializeEx を呼び出す場合、COINIT_MULTITHREADED ではなく COINIT_APARTMENTTHREADED を指定してください。詳細については、https://support.microsoft.com/default.aspx?scid=kb;ja-jp;828643 の「PRB: MFC アプリケーションは、マルチスレッド区画としてアプリケーションを初期化するとき、応答を停止します。」 (828643) を参照してください。

必要条件

ヘッダー : afxdisp.h

参照

概念

MFC マクロとグローバル

参照

AfxMessageBox