チュートリアル : テキストエディタを使った COM サーバーの作成

[アーティクル]
09/17/2008

属性は、面倒で複雑な従来の COM プログラミングを簡単にするために開発されました。属性を使ってアプリケーションを開発することで、COM の一般的な手順の多くを自動化したり簡略化したりできます。このチュートリアルでは、テキストエディタとコマンドラインツールを使って、簡単な COM サーバーを開発します。

アプリケーションで属性を使用するには、関連するマクロ (_ATL_ATTRIBUTES など) を定義し、関連するヘッダーファイルをインクルードして、属性のサポートを追加する必要があります。

ヘッダーファイルを作成するには

メモ帳または任意のテキストエディタを開きます。
MyIncludes.h という名前の新しいファイルを作成します。

次のコードを追加します。

#pragma once
#define STRICT
#ifndef _WIN32_WINNT
#define _WIN32_WINNT 0x0400
#endif
#define _ATL_ATTRIBUTES
#define _ATL_APARTMENT_THREADED
#define _ATL_NO_AUTOMATIC_NAMESPACE
#include <atlbase.h>
#include <atlcom.h>
#include <atlwin.h>
#include <atltypes.h>
#include <atlctl.h>
#include <atlhost.h>
using namespace ATL;

ファイルを保存します。

"atl" で始まるインクルードファイルは、アプリケーションに ATL のサポートを加えます。_ATL_ATTRIBUTES の定義により、属性付き ATL プログラミングのサポートも追加されます。

インプロセスサーバーを実装するソースファイルを作成する必要があります。

ソースファイルを作成するには

メモ帳で、MyServer.cpp という名前の新しいファイルを作成します。

次のコードを追加します。

#include "MyIncludes.h"
// The module attribute is specified in order to implement DllMain,
// DllRegisterServer and DllUnregisterServer
[ module(dll, name = "MyServer", helpstring = "MyServer 1.0 Type Library") ];
[ emitidl ];

ファイルを保存します。

module 属性を使うと、COM インプロセスサーバーに必要な機能を実装する手間が省かれます。また、.idl ファイルまたは .def ファイル (サーバーの関数をエクスポートするファイル) を記述する必要もありません。これらの作業はすべて、module 属性によって自動的に行われます。

プロジェクトをビルドするには

コマンドラインに次のコマンドを入力します。
```
cl /LD MyServer.cpp
regsvr32 MyServer.dll
```

エラーが発生した場合は、Visual Studio が正しくインストールされ、環境変数が定義されていることを確認してください。Visual Studio 環境変数は、[Visual Studio 2005 コマンドプロンプト] を実行して自動的に定義することも、<Visual Studio インストールディレクトリ>\Common7\Tools\vsvars32.bat にある vsvars32.bat を実行して手動で設定することもできます。

プロジェクトが正常にビルドされると、オペレーティングシステムにサーバーが登録されます。

この時点では、COM サーバーはクライアントに対してどの機能も公開していません。これは、COM サーバーにサーバーオブジェクトが実装されていないためです。次の手順として、このサーバーにサーバーオブジェクトを追加します。

サーバーにサーバーオブジェクトを追加するには

MyServer.cpp を開き、次のコードを追加します。

/////////////////////////////////////////////////////////////////////////////
// IObject1
[
   object,
   uuid("103FF9D9-8BC9-4ea8-8CD4-C1E627D04358"),
   dual,
   helpstring("IObject1 Interface"),
   pointer_default(unique)
]
__interface IObject1 : IDispatch
{
   HRESULT GetANum([out, retval]int* pInt);
};
/////////////////////////////////////////////////////////////////////////////
// CObject1
[
   coclass,
   threading(apartment),
   vi_progid("MyServer.Object1"),
   progid("MyServer.Object1.1"),
   version(1.0),
   uuid("15615078-523C-43A0-BE6F-651E78A89213"),
   helpstring("Object1 Class")
]
class ATL_NO_VTABLE CObject1 : 
   public IObject1
{
public:
   CObject1()
   {
   }
   HRESULT GetANum(int* pInt){
      *pInt = 101;
      return S_OK;
   }
   DECLARE_PROTECT_FINAL_CONSTRUCT()
   HRESULT FinalConstruct()
   {
      return S_OK;
   }

   void FinalRelease() 
   {
   }
};

変更を保存し、新しいコードをチェックします。

このコードにより、メソッドを 1 つ持つカスタムインターフェイス (IObject1) を実装する、簡単な COM オブジェクト (CObject1) が作成されます。このメソッド (GetANum) は、データメンバの値 (int 型) を返します。

変更を保存し、前の手順と同じコマンドを使って、アプリケーションを再ビルドします。

cl /LD MyServer.cpp
regsvr32 MyServer.dll

サーバーが動作するかどうかを調べるには、テスト用のクライアントアプリケーションを作成する必要があります。

テスト用クライアントアプリケーションを作成するには

メモ帳を開き、Comtest.cpp という名前の新しいファイルを作成します。

Comtest.cpp は、MyServer.cpp と同じフォルダにある必要があります。

Comtest.cpp に次のコードを追加します。

#include <iostream>
#include "atlbase.h"
#import "vc90.tlb" no_namespace
using namespace std;
int main()
{
   CoInitialize(NULL);
   {
      CComPtr<IUnknown> spUnknown;
            spUnknown.CoCreateInstance(__uuidof(CObject1));
      CComPtr<IObject1> pI;
      spUnknown.QueryInterface(&pI);
      int res = 0;
      res = pI->GetANum();
      cout << res << endl;
   }
   CoUninitialize();
}

クライアント側でサーバーの正しい動作を認識するには、#import キーワードを使って、サーバーのタイプライブラリをインポートする必要があります。サーバーを作成するときに名前を指定していないため、コンパイラによって生成されたタイプライブラリは、既定の名前 (vc90.tlb) になっています。前掲のコードの中にある次の行で、ライブラリがインポートされます。

#import "vc90.tlb" no_namespace

このファイルがテスト用アプリケーションにインポートされると、クライアントは COM サーバーの型情報にアクセスできます。型情報にアクセスできると、テスト用アプリケーションは、その中で定義されている任意の型 (CObject1 や IObject1 など) を参照できます。

テストアプリケーションをビルドおよび実行するには

コマンドラインに次のコマンドを入力します。
```
cl /EHsc comtest.cpp
```
次のコマンドを入力して、アプリケーションを実行します。
```
comtest
```

整数値が出力されます。

参照

概念

COM 属性による COM DLL の開発

チュートリアル : ウィザードを使った COM サーバーの作成

チュートリアル : テキスト エディタを使った COM サーバーの作成

ヘッダー ファイルを作成するには

ソース ファイルを作成するには

プロジェクトをビルドするには

サーバーにサーバー オブジェクトを追加するには

テスト用クライアント アプリケーションを作成するには

テスト アプリケーションをビルドおよび実行するには

参照

概念

その他のリソース