テクニカルノート 65: OLE オートメーションサーバーデュアルインターフェイスサポート

このノートでは、MFC ベースの OLE オートメーションサーバーアプリケーションにデュアルインターフェイスサポートを追加する方法について説明します。 ACDUALサンプルにデュアルインターフェイスサポートを示していて、このコード例は ACDUAL からとられています。このノートでは、ようマクロ DECLARE_DUAL_ERRORINFO 、 DUAL_ERRORINFO_PART 、および IMPLEMENT_DUAL_ERRORINFO 、ACDUAL のサンプルの一部であるし、MFCDUAL で見つけることができます。H。

デュアルインターフェイス

OLE オートメーションIDispatchインターフェイス、VTBL インターフェイス、または（両方を包含する) は、デュアルインターフェイスを実装することができますが、Microsoft は強く露出のすべての OLE オートメーションオブジェクトに対してデュアルインターフェイスを実装することを推奨します。デュアルインターフェイスのIDispatchの重要な利点がある-唯一のまたは VTBL のみのインターフェイス:

VTBL インターフェイスを介してコンパイル時または実行時にIDispatchをバインドの場所を取ることができます。
OLE、VTBL インターフェイスを使用するオートメーションコントローラーからのパフォーマンスを向上できます。
IDispatchインターフェイスを使用して既存の OLE オートメーションコントローラーが作業を継続します。
VTBL インターフェイスは C++ から呼び出すほうが簡単です。
デュアルインターフェイスの Visual Basic オブジェクトサポート機能との互換性が必要です。

CCmdTarget に基づいたクラスへのデュアルインターフェイスサポートを追加

デュアルインターフェイスはIDispatchから派生したカスタムインターフェイスは本当にだけです。CCmdTargetにデュアルインターフェイスサポートを実装する最も簡単な方法-ベースクラスは通常のディスパッチインターフェイスの MFC と ClassWizard を使用して、クラスにし、カスタムインターフェイスを後で追加の最初の実装をします。ほとんどの部分については、カスタムインターフェイスの実装は単に、MFC のIDispatch実装に戻る委任します。

最初に、オブジェクトはデュアルインターフェイスを定義するのには、サーバー用の ODL ファイルを変更します。デュアルインターフェイスを定義するのには、インターフェイスステートメントの代わりに使用する必要があります、 DISPINTERFACE 、Visual C のウィザードを生成するステートメント。既存を削除するのではなく DISPINTERFACE ステートメントは、新しいインターフェイスステートメントを追加します。保持によって、 DISPINTERFACE 、できますフォーム、引き続き ClassWizard を使用してプロパティとメソッドをオブジェクトに追加するには、同等のプロパティ、メソッド、インターフェイスステートメントを追加する必要があります。

Ole オートメーションとデュアル属性、インターフェイスステートメントは、デュアルインターフェイスの必要があり、インターフェイスはIDispatchから派生する必要があります。使用して、、デュアルインターフェイスのIIDを作成するには、 GUIDGENサンプル

[uuid(0BDD0E81-0DD7-11cf-BBA8-444553540000)、・ ・ IID_IDualAClick特価;ole オートメーション、デュアル]IDualAClick インタ フェース: IDispatch{}(&N)

場所で、インターフェイスステートメントとは、メソッドとプロパティのエントリを追加を開始します。デュアルインターフェイスは、プロパティアクセサー関数はデュアルインターフェイスで、メソッドがHRESULTを返すし、戻り値、属性をパラメーターとして渡すパラメーターの一覧に配置する必要があります [retval,out] 。プロパティの両方を追加する必要があります覚えて ( propget ) と書き込み ( propput )、同じ id を持つ関数にアクセスします。たとえば:

[propput、id(1)]HRESULT テキスト ([in] BSTR newText);propget [id(1)]HRESULT テキスト ([out, retval] BSTR ※ retval)

メソッドとプロパティを定義したら、コクラスステートメントでインターフェイスステートメントへの参照を追加する必要があります。たとえば:

[uuid(4B115281-32F0-11cf-AC85-444553540000)]コクラス ドキュメント{特価;ディスパッチ インターフェイス IAClick;[既定] のインターフェイス IDualAClick;}(&N)

ODL ファイルを更新すると、MFC のインターフェイスマップ機構を使用してデュアルインターフェイス用実装クラス、オブジェクトクラスの定義し、MFC のQueryInterface機構内の対応するエントリを確認します。1 つのエントリ必要があります、 INTERFACE_PART 、ODL のインターフェイスステートメント内の各エントリエントリに加え、ディスパッチインターフェイスのブロック。各 ODL エントリpropput属性を持つ必要があるという名前の関数 put_propertyname 。各エントリpropget属性を持つ必要があるという名前の関数get_propertyname。

デュアルインターフェイス用実装クラスを定義するには、追加、 DUAL_INTERFACE_PART ブロックをオブジェクトのクラス定義に。たとえば:

BEGIN_DUAL_INTERFACE_PART (DualAClick, IDualAClick)STDMETHOD(put_text) (THIS_ BSTR newText);STDMETHOD(get_text) (THIS_ BSTR まで ※ retval);STDMETHOD(put_x) (THIS_ 短い newX);STDMETHOD(get_x) (retval THIS_ 短いまで ※);STDMETHOD(put_y) (THIS_ 短い newY);STDMETHOD(get_y) (retval THIS_ 短いまで ※);STDMETHOD(put_Position) (THIS_ IDualAutoClickPoint まで ※ newPosition);STDMETHOD(get_Position) (THIS_ IDualAutoClickPoint まで ※ まで ※ retval);STDMETHOD(RefreshWindow)(THIS);STDMETHOD(SetAllProps) （THIS_ ショート x、短い y、BSTR 本文);STDMETHOD(ShowWindow)(THIS);END_DUAL_INTERFACE_PART(DualAClick)

MFC のデュアルインターフェイスを接続するの QueryInterface機構、追加、 INTERFACE_PART エントリのインターフェイスマップに

BEGIN_INTERFACE_MAP (CAutoClickDoc、CDocument)INTERFACE_PART (CAutoClickDoc、DIID_IAClick、ディスパッチ)INTERFACE_PART (CAutoClickDoc、IID_IDualAClick、DualAClick）END_INTERFACE_MAP()

次に、インターフェイスの実装では、入力する必要があります。ほとんどの部分については、既存の MFC のIDispatchの実装に委任できます。たとえば:

STDMETHODIMP_(ULONG) CAutoClickDoc::XDualAClick::AddRef()
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   return pThis->ExternalAddRef();
}
STDMETHODIMP_(ULONG) CAutoClickDoc::XDualAClick::Release()
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   return pThis->ExternalRelease();
}
STDMETHODIMP CAutoClickDoc::XDualAClick::QueryInterface(
             REFIID iid, LPVOID* ppvObj)
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   return pThis->ExternalQueryInterface(&iid, ppvObj);
}
STDMETHODIMP CAutoClickDoc::XDualAClick::GetTypeInfoCount(
            UINT FAR* pctinfo)
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   LPDISPATCH lpDispatch = pThis->GetIDispatch(FALSE);
   ASSERT(lpDispatch != NULL);
   return lpDispatch->GetTypeInfoCount(pctinfo);
}
STDMETHODIMP CAutoClickDoc::XDualAClick::GetTypeInfo(
          UINT itinfo, LCID lcid, ITypeInfo FAR* FAR* pptinfo)
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   LPDISPATCH lpDispatch = pThis->GetIDispatch(FALSE);
   ASSERT(lpDispatch != NULL);
   return lpDispatch->GetTypeInfo(itinfo, lcid, pptinfo);
}
STDMETHODIMP CAutoClickDoc::XDualAClick::GetIDsOfNames(
       REFIID riid, OLECHAR FAR* FAR* rgszNames, UINT cNames,
       LCID lcid, DISPID FAR* rgdispid) 
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   LPDISPATCH lpDispatch = pThis->GetIDispatch(FALSE);
   ASSERT(lpDispatch != NULL);
   return lpDispatch->GetIDsOfNames(riid, rgszNames, cNames, 
                                    lcid, rgdispid);
}
STDMETHODIMP CAutoClickDoc::XDualAClick::Invoke(
    DISPID dispidMember, REFIID riid, LCID lcid, WORD wFlags,
    DISPPARAMS FAR* pdispparams, VARIANT FAR* pvarResult,
    EXCEPINFO FAR* pexcepinfo, UINT FAR* puArgErr)
{
   METHOD_PROLOGUE(CAutoClickDoc, DualAClick)
   LPDISPATCH lpDispatch = pThis->GetIDispatch(FALSE);
   ASSERT(lpDispatch != NULL);
   return lpDispatch->Invoke(dispidMember, riid, lcid,
                             wFlags, pdispparams, pvarResult,
                             pexcepinfo, puArgErr);
}

オブジェクトのメソッド、プロパティアクセサー関数を実装する必要があります。あなたのメソッドとプロパティの機能は、一般的に ClassWizard を使用して生成したメソッドに委任できます。ただし、プロパティを変数に直接アクセスする場合は、値を変数に取得するコードを記述する必要があります。たとえば:

STDMETHODIMP CAutoClickDoc::XDualAClick::put_text(BSTR newText){特価;METHOD_PROLOGUE (CAutoClickDoc, DualAClick)//MFC を自動的に変換 Unicode BSTR から・ ・ Ansi CString、必要に応じて.pThis - > m_str newText; =NOERROR を返す;}STDMETHODIMP CAutoClickDoc::XDualAClick::get_text(BSTR* retval){METHOD_PROLOGUE (CAutoClickDoc, DualAClick)//MFC を自動的に変換する Ansi CString から//Unicode BSTR、必要に応じて.pThis - > m_str。SetSysString(retval);NOERROR を返す;}

デュアルインターフェイスのポインターを渡します

デュアルインターフェイスポインターを渡すは特にCCmdTarget::FromIDispatchを呼び出す必要がある場合に、簡単ではありません。FromIDispatchは、MFC のIDispatchポインターにのみ動作します。この問題を回避する 1 つの方法は、元のIDispatchポインターセット MFC でし、ポインターが必要な関数に渡すをクエリします。たとえば

 STDMETHODIMP CAutoClickDoc::XDualAClick::put_Position (特価;IDualAutoClickPoint まで ※ newPosition）{METHOD_PROLOGUE (CAutoClickDoc, DualAClick)LPDISPATCH lpDisp = NULL;newPosition - > QueryInterface (IID_IDispatch、(LPVOID ※） ＆ lpDisp);pThis - > SetPosition(lpDisp);lpDisp - > Release();NOERROR を返す;}

デュアルインターフェイスメソッドから戻るポインターを渡す前に、MFC のIDispatchポインターからデュアルインターフェイスポインターに変換する必要があります。たとえば:

STDMETHODIMP CAutoClickDoc::XDualAClick::get_Position (特価;IDualAutoClickPoint まで ※ まで ※ retval){METHOD_PROLOGUE (CAutoClickDoc, DualAClick)LPDISPATCH lpDisp;lpDisp = pThis - > GetPosition();lpDisp - > QueryInterface (IID_IDualAutoClickPoint、(LPVOID ※) retval);NOERROR を返す;}

アプリケーションのタイプライブラリの登録

AppWizard では、OLE オートメーションサーバーアプリケーションのタイプライブラリをシステムに登録するコードは生成されません。タイプライブラリを登録する他の方法がありますが、スタンドアロンアプリケーションを実行するたびに、その OLE の種類の情報は、更新しているときに、タイプライブラリを登録アプリケーションに便利です。

アプリケーションがスタンドアロンで実行されるたびに、アプリケーションのタイプライブラリを登録するには:

AFXCTL が含まれます。時間標準のにはヘッダーファイル、STDAFX が含まれています。H AfxOleRegisterTypeLib関数の定義にアクセスするには、。

アプリケーションの InitInstance 機能、 COleObjectFactory::UpdateRegistryAllへの呼び出しを探します。この呼び出し後は、 AfxOleRegisterTypeLibに対応するタイプライブラリの名前と共に、タイプライブラリのLIBIDを指定して、呼び出しを追加します。

・ スタンドアロン サーバー アプリケーションを起動すると、それは良いアイデアです//それが損傷している場合、システム レジストリを更新します。m_server。UpdateRegistry(OAT_DISPATCH_OBJECT);COleObjectFactory::UpdateRegistryAll();//DUAL_SUPPORT_START//タイプ ライブラリが登録されているか、デュアル インターフェイスは動作しませんを確認してください。AfxOleRegisterTypeLib(AfxGetInstanceHandle()、LIBID_ACDual、_T("AutoClik.TLB"));//DUAL_SUPPORT_END

タイプライブラリの変更に対応するプロジェクトのビルド設定を変更します。

UUID定義を含むヘッダーファイルが生成されるように変更するには、プロジェクトのビルド設定タイプライブラリが再構築されるたびにMkTypLib

[ビルド] メニューの [から設定をクリックし、ファイルの一覧から ODL ファイルを選択。
[OLE タイプ] タブをクリックし、[出力ヘッダーファイル名] フィールドにファイル名を指定します。MkTypLib が既存のファイルを上書きするので、あなたのプロジェクトでは、まだ使用されていないファイル名を使用します。[ビルド設定] ダイアログボックスを閉じるには、[ok] をクリックします。

UUID定義から MkTypLib によって生成されたヘッダーファイルをプロジェクトに追加するには:

MkTypLib 生成が含まれます、標準のヘッダーファイルには、ヘッダーファイル、STDAFX が含まれています。H。
新しいファイル、INITIIDS を作成します。CPP、それをプロジェクトに追加します。このファイルには、OLE2 を含む後に、MkTypLib によって生成されたヘッダーファイルが含まれます。H と INITGUID。H:
```
//initIIDs.c: デュアル インターフェイスの Iid を定義します//このプリコンパイル済みヘッダーを構築する必要がありません。#include lt;ole2.h >#include <initguid.h>#include"acdual.h"
```
ビルド] メニューの [設定] をクリックし、INITIIDS を選択します。CPP ファイルリストの各構成から。
[C++] タブをクリックし、カテゴリ「プリコンパイル済みヘッダー」と選択"を使用していないヘッダープリコンパイル」ラジオボタン。[ビルド設定] ダイアログボックスを閉じるには、[ok] をクリックします。

タイプライブラリに、正しいオブジェクトクラス名を指定します。

Visual C での出荷されていないウィザードでは、実装クラス名を使用してサーバーの ODL ファイル内の OLE createable クラス、コクラスを指定します。動作はしますが、実装クラス名を使用するユーザーオブジェクトのクラス名はありません。正しい名前を指定するには、ODL ファイルを開く各コクラスステートメントを見つけます、実装クラス名を正しい外部名を置き換える。

Coclass ステートメントが変更されたときに、 CLSIDの MkTypLib によって生成されたヘッダーファイルでの変数の名前に応じて変わります。新しい変数名を使用するようにコードを更新する必要があります。

例外とオートメーションエラーインターフェイスの処理

オートメーションオブジェクトのメソッドとプロパティアクセサー関数例外をスロー可能性があります。場合は、それらは、デュアルインターフェイスの実装で処理し、OLE オートメーションエラー処理インターフェイスIErrorInfoを通じてコントローラーに戻る、例外に関する情報を渡す必要があります。このインターフェイスは、 idispatch インターフェイスと VTBL インターフェイスを介しての詳細は、文脈上のエラー情報を提供します。エラーハンドラーが利用可能であることを示すには、 ISupportErrorInfoインターフェイスを実装する必要があります。

エラー処理機構を説明するには、標準のディスパッチのサポートを実装するために使用、ClassWizard で生成された関数例外をスローすることを想定しています。MFC の実装idispatch::invokeは通常これらの例外をキャッチし、EXCEPTINFO には構造変換呼び出しを通じて返されます。ただし、VTBL インターフェイスを使用すると、例外をキャッチするの責任があります。たとえば、デュアルインターフェイスのメソッドを保護します。

STDMETHODIMP CAutoClickDoc::XDualAClick::put_text(BSTR newText){特価;METHOD_PROLOGUE (CAutoClickDoc, DualAClick)TRY_DUAL(IID_IDualAClick){//MFC を自動的に変換 Unicode BSTR から・ ・ Ansi CString、必要に応じて.pThis - > m_str newText; =NOERROR を返す;}CATCH_ALL_DUAL}

CATCH_ALL_DUAL例外が発生した場合、正しいエラーコードを返すの世話します。CATCH_ALL_DUALMFC 例外ICreateErrorInfoインターフェイスを使用して OLE オートメーションエラー処理情報に変換します。（例 CATCH_ALL_DUAL マクロは、ファイルに MFCDUAL。H で、 ACDUALサンプル。関数が例外を処理する呼び出し DualHandleException 、MFCDUAL ファイルであります。CPP。)CATCH_ALL_DUALに発生した例外の種類に基づいて返すエラーコードを指定します

COleDispatchException -このケースでは、 HRESULTは次のコードを使用して構築されます。:
```
hr = MAKE_HRESULT (SEVERITY_ERROR、FACILITY_ITF、特価;（e - > m_wCode + 0x200))
```
これがHRESULTを特定の例外が発生したインタフェースを作成します。エラーコードでシステム定義のHRESULTs の標準 OLE インターフェイスと競合しないように 0x200 オフセットします。
CMemoryException -この場合、 E_OUTOFMEMORY が返されます。
その他の例外-この場合、 E_UNEXPECTED が返されます。

OLE オートメーションのエラーハンドラーを使用することを示すには、また、 ISupportErrorInfoインターフェイスを実装する必要があります。

まず、 ISupportErrorInfoサポートを表示するには、オートメーションクラス定義にコードを追加します。

第二に、コードは MFC のQueryInterface機構ISupportErrorInfo実装クラスを関連付けるには、オートメーションクラスのインターフェイスマップに追加します。INTERFACE_PARTステートメントISupportErrorInfoは定義クラスと一致します。

最後に、 ISupportErrorInfoをサポートするために定義されているクラスを実装します。

(、 ACDUALサンプルには、これら 3 つの手順を実行する 3 つのマクロが含まれている DECLARE_DUAL_ERRORINFO 、 DUAL_ERRORINFO_PART 、および IMPLEMENT_DUAL_ERRORINFO 、すべて MFCDUAL に含まれています。H.)

次の例は、 ISupportErrorInfoをサポートするために定義されたクラスを実装します。CAutoClickDocオートメーションクラスの名前を指定し、 IID_IDualAClick エラーのソースインターフェイスのIID OLE オートメーションエラーオブジェクトを介して報告されています。:

STDMETHODIMP_(ULONG) CAutoClickDoc::XSupportErrorInfo::AddRef() （特価;METHOD_PROLOGUE (CAutoClickDoc, SupportErrorInfo) pThis - 戻る > ExternalAddRef();} STDMETHODIMP_(ULONG) CAutoClickDoc::XSupportErrorInfo::Release() {METHOD_PROLOGUE (CAutoClickDoc、SupportErrorInfo) を返す pThis - > ExternalRelease();} STDMETHODIMP CAutoClickDoc::XSupportErrorInfo::QueryInterface (REFIID iid、LPVOID ※ ppvObj) {METHOD_PROLOGUE (CAutoClickDoc、SupportErrorInfo) を返す pThis - > ExternalQueryInterface (＆ iid、ppvObj);} STDMETHODIMP CAutoClickDoc::XSupportErrorInfo::InterfaceSupportsErrorInfo (REFIID iid) {METHOD_PROLOGUE (CAutoClickDoc、SupportErrorInfo） 戻り (iid IID_IDualAClick = =) か。S_OK: S_FALSE;}

番号順テクニカルノート|nbsp;カテゴリ別テクニカルノート(&N)

Index

テクニカル ノート 65: OLE オートメーション サーバー デュアル インターフェイス サポート

テクニカルノート 65: OLE オートメーションサーバーデュアルインターフェイスサポート