使用ATL创建进程外组件

一、建立一个进程外组件
1)打开菜单File|New，选择Projects标签，然后选择“ATL COM AppWizard”
2)在Project name栏输入step02，单击ok按钮，在下一个窗口中的Server Type栏选择
“Executable (Exe)”之后，单击Finish按钮

然后插入对象（与创建进程内组件类似）：
3)打开菜单Insert|New ATL Object，在左边的Category中选择Objects，在右边的
Objects中选择Simple Object，单击“Next”按钮
4)在Names标签中，Short Name栏填写Simple02，不修改其他的属性，单击
“确定”按钮。

加入接口方法：
5)在Workspace的ClassView标签中右击“ISimple02”接口，从弹出的菜单中选择
“Add Method”，在弹出的窗口中，Method Name栏填写GetOSVersion，Parameters
栏填写[out, retval]BSTR * bstrVersion

修改类CSimple02的函数STDMETHODIMP CSimple02::GetOSVersion(BSTR *bstrVersion)如下：

// Simple02.cpp : Implementation of CSimple02
#include "stdafx.h"
#include "Step02.h"
#include "Simple02.h"

// 加入comutil支持
#include <comutil.h>
#pragma comment( lib, "comsupp.lib" )

/////////////////////////////////////////////////////////////////////////////
// CSimple02

// 取操作系统信息
STDMETHODIMP CSimple02::GetOSVersion(BSTR *bstrVersion)
{
 char szOSVersion[10];
 OSVERSIONINFO VersionInformation;
        VersionInformation.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
 if(GetVersionEx(&VersionInformation))
 {
  switch(VersionInformation.dwPlatformId)
  {
  case VER_PLATFORM_WIN32s:
   strcpy(szOSVersion, "WIN32S");
   break;
  case VER_PLATFORM_WIN32_WINDOWS:
   strcpy(szOSVersion, "WIN95/98");
   break;
  case VER_PLATFORM_WIN32_NT:
   strcpy(szOSVersion, "WINNT");
   break;
  default:
   strcpy(szOSVersion, "UnKnown");
   break;
  }
 }
 else
 {
  strcpy(szOSVersion, "Error");
 }
 *bstrVersion = _com_util::ConvertStringToBSTR(szOSVersion);
 return S_OK;
}

编译程序，至此我们建立了一个进程外组件，下面我们编译proxy/stub程序
6)进入“MS DOS”状态，找到Step02的目录，运行nmake step02ps.mk，将创建一个
名为Step02ps.dll动态连接库。

二、建立客户程序
1)打开菜单File|New，选择Projects标签，然后选择“Win32 Console Application”
2)在Project name栏输入Client，单击ok按钮，在下一个窗口单击Finish按钮

新建如下文件，并加入工程：
// Client.cpp 文件

#include <windows.h>
#include <stdio.h>
// 加入comutil支持
#include <comutil.h>
#pragma comment( lib, "comsupp.lib" )

// 包含com的定义文件，以下两个文件从step02中拷贝出来
#include "..\step02\step02.h"
#include "..\step02\step02_i.c"

void main()
{
 ISimple02 * pISimple02=NULL;  // 我们定义的接口
 BSTR  bstrOS;

 // 初始化
 HRESULT hr = CoInitialize(NULL);
 if(FAILED(hr))
 {
  printf("Coinitialize failed! hr=0x%x", hr);
  return ;
 }

 // 创建COM对象
 hr = CoCreateInstance(CLSID_Simple02, NULL, CLSCTX_ALL,
                    IID_ISimple02, (void **)&pISimple02);
 if(FAILED(hr))
 {
  printf("create com failed! hr=0x%x", hr);
  CoUninitialize();
  return ;
 }
 // 获得操作系统
 hr = pISimple02->GetOSVersion(&bstrOS);
 if(FAILED(hr))
 {
  printf("pISimple02->GetOSVersion() failed! hr=0x%x", hr);
  pISimple02->Release();
  CoUninitialize();
  return ;
 }
 char *pszOS;
 pszOS = _com_util::ConvertBSTRToString(bstrOS);
 printf("The OS is %s\n", pszOS);

 // 释放分配的内存
 SysFreeString(bstrOS);
 delete pszOS;
 pISimple02->Release();
 CoUninitialize();

 return ;
}

三、说明
1)进程外组件的注册使用：
  step02.exe /regserver
  注销使用：
  step02.exe /unregserver

在windows 98下运行我们的Client.exe，可以得到
The OS is WIN95/98
在windows 2000下运行我们的Client.exe，可以得到
The OS is WINNT

四、常见问题
如果没出现上面的结果，提示为：
create com failed! hr=0x80040154
解决方法是，进入MS DOS方式，找到step02\debug目录，运行step02.exe /regserver
再试一次。