CreateMAPIInitializationMonitor
適用対象: Outlook 2016 |Outlook 2019
MAPI 初期化モニター
MAPI を使用するアプリケーションが初期化が完了したときに知りたい場合があります。 たとえば、MAPI を初期化できる複数のスレッドがある場合や、MAPI を初期化する場合に応答して、アプリケーションは何らかの作業を実行しますが、MAPI スタックを常に起動したくありません。 初期化モニターは、(OLMAPI32.DLL からエクスポートされた) 関数と、以下で説明するいくつかの単純なインターフェイスを使用して、この機能を提供します。
HRESULT CreateMAPIInitializationMonitor(IMAPIInitMonitor** ppInitMonitor);
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
OLMAPI32.DLL からエクスポートされたこのエントリ ポイントを使用すると、呼び出し元はインターフェイスを取得して現在の初期化状態を照会したり、初期化完了のコールバックを設定したり、完了するまで現在のスレッドをブロックしたりできます。 この API から返されるオブジェクトは再利用可能でスレッド セーフであり、取得したスレッドだけでなく、任意のスレッドから呼び出すことができます。 また、MAPI から公開されている他のオブジェクトとは異なり、このオブジェクトは DLL が読み込まれている限り有効であり、初期化セッション間で再利用でき、MAPIInitialize が呼び出された前または後に使用できます。 COM 標準 HRESULT を使用して成功または失敗を返し、IMAPIInitMonitor のインスタンスに out パラメーターを割り当てます。
パラメーター
ppInitMonitor
[out]MAPI 初期化モニターの新しく作成されたインスタンスを受け取るポインター。
戻り値
S_OK
初期化モニターの新しいインスタンスが正常に作成されました。
E_OUTOFMEMORY
新しいオブジェクトをクレートするのに十分なメモリが不足していました。