COM实验指导

### COM实验指导——ATL工程项目创建与实现 #### 一、建立ATL工程 在进行COM组件开发时，首先需要创建一个ATL工程。这里详细介绍如何通过Visual Studio等IDE工具来构建一个简单的COM组件工程。 **步骤1：** 创建一个工作区(WorkSpace)。 - 打开Visual Studio，选择“文件”->“新建”->“项目”。 - 在“新建项目”对话框中，选择“Win32控制台应用程序”或“空项目”，这里建议选择“空项目”。 - 输入工作区名称，例如“SimpleCom”。 **步骤2：** 在工作区中新建一个ATL工程(Project)。 - 右键点击工作区，在弹出的菜单中选择“新建”->“项目”。 - 在“新建项目”对话框中选择“ATL COM AppWizard”，然后点击“确定”。 - 在下一步中，输入项目名称“SimpleCom”，并选择DLL类型。 #### 二、增加ATL对象类 接下来，我们将通过向导来添加一个新的ATL对象类。 **步骤3：** 选择菜单`Insert` -> `New ATL Object` -> `Object`分类 -> `SimpleObject`项目。 - 在弹出的向导中，选择“Category Object”类别下的“Simple Object”。 - 输入类名，例如`CMath`，以及接口名`IMath`。 - 点击“完成”。 **步骤4：** 填写接口属性。 - 在弹出的接口属性设置界面中，可以进行以下配置： - **ThreadingModel**：选择组件支持的线程模型，如`Apartment`表示单线程模型，`Free`表示多线程模型。 - **Interface**：选择接口类型，如`Dual`表示支持双接口，`Custom`表示自定义接口。 - **Aggregation**：设置是否允许其他对象聚合使用当前对象。 - **SupportISupportErrorInfo**：设置是否支持更丰富的错误处理机制。 - **SupportConnectionPoints**：设置是否支持连接点接口（用于事件和回调）。 - **FreeThreadedMarshaler**：设置是否支持自由线程模式的内存分配器。 #### 三、添加接口函数 在ATL工程中，可以通过向导或手动编辑IDC文件来添加接口函数。 **步骤5：** 添加接口函数`Add`。 - 通过向导添加接口函数时，需要指定参数的方向和返回值类型。例如： - `[in]` 表示参数方向是输入； - `[out]` 表示参数方向是输出； - `[out,retval]` 表示参数方向是输出，同时也是函数的返回值。 #### 四、添加接口`IStr` 除了通过向导添加接口外，还可以手动编辑IDC文件来添加新的接口。 **步骤6：** 在IDL文件中手动添加代码。 - 需要导入必要的接口描述文件： ```idl import "oaidl.idl"; import "ocidl.idl"; ``` - 定义接口`IMath`： ```idl [ object, uuid(E34275D2-B3CA-4BCA-9AC7-0713ABE2F876), helpstring("IMath Interface"), pointer_default(unique) ] interface IMath : IUnknown { [helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out, retval] long *pnVal); }; ``` - 手动添加新接口`IStr`： ```idl [ object, uuid(36A75A3F-94DE-47fe-AF51-0C0C65316A03), helpstring("IStr Interface"), pointer_default(unique) ] interface IStr : IUnknown { // 目前还没有任何接口函数 }; ``` 通过以上步骤，我们成功创建了一个包含两个接口（`IMath`和`IStr`）的ATL工程。这个过程不仅介绍了如何构建基础的ATL工程，还涵盖了接口的定义、属性配置以及接口函数的添加等多个方面，为后续的COM组件开发打下了坚实的基础。