通过

ATLDuck 示例：将连接点用于 ATL

  • 项目

更新：2007 年 11 月

ATLDuck 示例由四个项目组成：atlduck、duck 及其各自的代理/存根 (stub) 项目 atlduckPS 和 duckPS。duck 项目创建实现 IDuckInt 接口的对象的实例。此接口包括四个成员函数：Flap、Paddle、Quack 和 Walk。

第二个项目 atlduck 有一个 IDuckInt 接口的连接点（即它知道如何使用该接口但并不实现该接口）。将只创建该对象的一个实例。当两个应用程序之间建立连接后，atlduck 将为已调用 IConnectionPoint::Advise 的接收器调用 IDuckInt 接口中的函数。

此示例还使用了连接不同进程中的接口所需的封送处理代码（通过 atlduckPS 和 duckPS）。

ATLDuck 属性示例是此示例的属性化版本。

安全说明：

提供该示例代码是为了阐释一个概念，并不代表着最安全的编码实践，因此不应在应用程序或网站中使用该示例代码。对于超出本示例代码的预期用途以外的使用所造成的偶然或继发性损失，Microsoft 不承担任何责任。

获取示例和安装示例的说明：

  • 在 Visual Studio 的“帮助”菜单上，单击“示例”。

    有关更多信息，请参见定位示例文件。

  • 示例的最新版本和完整列表可以从 Visual Studio 2008 Samples page（Visual Studio 2008 示例页面）联机获取。

  • 还可以在计算机的硬盘上查找示例。默认情况下，示例和自述文件将复制到 \Program Files\Visual Studio 9.0\Samples\ 下的文件夹中。对于 Visual Studio 速成版，所有示例都位于联机位置。

生成并运行示例

生成此示例

  1. 打开 atlduck.sln 解决方案文件。

  2. 在“生成”菜单中，单击“生成解决方案”。这将生成所有四个项目并进行必要的注册。将创建以下文件：

    • atlduck.exe，EXE 服务器

    • atlduckPS.dll，atlduck.exe 服务器的封送处理 DLL

    • duck.exe，EXE 客户端

    • duckPS.dll，duck.exe 客户端的封送处理 DLL

运行此示例

  1. 启动 duck.exe 的一个或多个实例。

    说明：

    打开 duck.exe 的若干个实例可最有效地演示连接点。

  2. 出现一个对话框。在该对话框中，单击“Create DoDuck Object”按钮。单击此按钮后，应用程序将通过运行 atlduck 来创建具有类 ID CLSID_DuckDoer 的对象的实例。

  3. 出现一个由 atlduck.exe 发出的新的对话框。此对话框不但为 IDuckInt 接口中的每个函数显示一个按钮，而且还显示连接到活动接收器的列表框和它们的 Cookie。从 duck 对话框中，可以 Advise 或 Unadvise 连接点。根据您的选择，您将收到或者不会收到来自源的通知。接收到通知后，该通知将显示在状态编辑字段中。另外，ATLDuck 还说明了当通知连接时由连接点提供的 Cookie 的值。

类和关键字

此示例使用下面的类：

CDialog (MFC)、CComObject (ATL)、IConnectionPointImpl<CDuckDoer> (ATL)

此示例使用以下关键字：

_ASSERTE；_tcslen；_VERIFY；AddRef；Advise；BEGIN_COM_MAP；BEGIN_CONNECTION_POINT_MAP；BEGIN_MSG_MAP；BEGIN_OBJECT_MAP；CComCoClass；CComModule::Unlock；CComObjectRootEx；CDialogImpl；CenterWindow；CoInitialize；COM_INTERFACE_ENTRY；COM_INTERFACE_ENTRY_IMPL；COMMAND_HANDLER；COMMAND_ID_HANDLER；CONNECTION_POINT_ENTRY；CoSuspendClassObjects；CoUninitialize；Create；DECLARE_CLASSFACTORY_SINGLETON；DECLARE_NOT_AGGREGATABLE；DECLARE_REGISTRY_RESOURCEID；DestroyWindow；DispatchMessage；EnableWindow；END_COM_MAP；END_CONNECTION_POINT_MAP；END_MSG_MAP；END_OBJECT_MAP；ExitProcess；FindConnectionPoint；GetCommandLine；GetDC；GetDlgItem；GetMessage；GetTextExtentPoint32；IConnectionPointContainerImpl；IConnectionPointImpl；Init；IsWindowVisible；MESSAGE_HANDLER；MessageBox；OBJECT_ENTRY；OleInitializeCoCreateInstance；OnCancel；OnFlap；OnInitDialog；OnOK；OnPaddle；OnWalk OnQuack；PostThreadMessage；QueryInterface；RecalcListboxExtent；RegisterClassObjects；RegisterServer；reinterpret_cast；ReleaseDC；RevokeClassObjects；SendMessage；SetOwner；SetWindowText；ShowStatus；ShowWindow；Unadvise；UnregisterServer；UNUSED_ALWAYS；UpdateRegistryFromResource；UpdateWindow；USES_CONVERSION

请参见

其他资源

ATL 示例