使用 ATL 开发 MMC 管理单元

IDataObject

此接口由ATL中的 CSnapInDataObjectImpl实现。我们不直接与之接触。ATL会处理它。当MMC调用QueryDataObject，然后调用GetDataObject等时，它会被创建。
数据对象和MMC (MSDN)

IPersistStreamInit

此接口可以由 IComponentData和 IComponent派生类使用，以提供持久化支持。例如，您可以保存计算机名、IP地址、文件夹名、服务名等...

IExtendContextMenu、IExtendPropertySheet(2)和 IExtendControlbar可用于扩展管理单元插件的弹出菜单、属性页和控件条。
ISnapinHelp(2)用于通知MMC我们支持帮助。强烈建议管理单元插件提供帮助。
IDisplayHelp可用于通过响应MMC的MMCN_CONTEXTHELP消息来支持上下文相关的帮助。

最好的做法是将 CSimpleData重命名为CStaticNode。我认为这样更清晰，但我保留了原样。为了稍微简化我们的工作，我们需要为节点创建一个基类。此类将提供所有默认初始化和函数，而无需在所有节点类中重复。我添加了一个CBaseNodeItem，它继承自 CSnapInItemImpl并提供简单的初始化。如果您查看 CBaseNodeItem类，您会发现它在构造函数、GetScopePaneInfo、GetResultPaneInfo和Notify中执行一些通用操作，这些操作在大多数项中共享。Notify方法负责处理各种MMC消息，并且是从MMC接收通知的主要方式。显而易见的优势是Notify方法位于基类中。我们所要做的就是为每条消息调用适当的虚拟函数，并且会调用我们节点的正确函数。所以现在任何新的范围节点或结果项都将继承自CBaseNodeItem。

添加项目

任何新的范围节点或结果项都将继承自CBaseNodeItem。MMC中的项由 SCOPEDATAITEM和 RESULTDATAITEM结构表示。

将项目添加到结果窗格

• 派生另一个 CBaseNodeItem，它将代表结果项。定义剪贴板变量。我将GUID设置为GUID_NULL。
• MMCN_SHOW - 在Notify中响应MMC的此消息。我们只需调用虚拟OnShow函数。插入列/项。
• GetResultViewType - 根据需要设置参数。列表视图、任务板或ActiveX控件。
• GetResultPaneInfo - 调用虚拟GetResultPaneColInfo来获取列表项。

将项目添加到范围窗格

• 从 CBaseNode派生另一个类，它将代表范围项。定义剪贴板变量。
• 在父节点类中创建新类的成员。
• MMCN_EXPAND - 处理MMC的此消息。我们只需调用我们的虚拟OnExpand。
• 定义剪贴板格式值（m_NODETYPE、m_SZNODETYPE、m_SZDISPLAY_NAME、m_SNAPIN_CLASSID、CSomeNodeGUID_NODETYPE）

添加帮助

使用HTML帮助向导创建一个简单的HTML帮助项目。处理MMCN_CONTEXTHELP。这将启用F1上下文敏感帮助。让IComponentData派生类继承自ISnapinHelp2。为GetHelpTopic提供实现（告知帮助文件目录）。有关如何指定帮助主题格式，请参阅ShowTopic的帮助。现在，范围窗格中的每个节点和结果窗格中的每个项都可以拥有自己的帮助文件条目。帮助文件将与MMC的帮助文件合并。所以您可以添加自己的标题等。 实现帮助 (MSDN)

添加MessageView

MMC 1.2具有MessageView OCX控件，可用于向用户提供一些有用的信息。
创建方式与创建ActiveX类似。只需实现GetResultViewType并提供CLSID_MessageView。在OnShow期间，使用QueryResultView来访问IMessageView接口并对其进行操作。

使用MMC消息OCX控件 (MSDN)

添加属性页

提供属性页

• 从CSnapInPropertyPageImpl派生一个类
• 为您的范围窗格或结果窗格项实现QueryPagesFor
• 为您的范围窗格或结果窗格项实现CreatePropertyPages
• 启用MMC_VERB_PROPERTIES动词。我在OnSelect中这样做了
• 保存父类的指针以进行数据交换（如果需要）
• 您可以使用属性页类的PropertyChangeNotify函数，该函数会转换为MMCN_PROPERTY_CHANGE。
  您必须重写IComponentDataImpl派生类的Notify函数，并为lpDataObject == NULL的情况提供实现，并处理MMCN_PROPERTY_CHANGE事件。

(**题外话**：存在不同的预定义MMC动词，如MMC_VERB_RENAME、MMC_VERB_DELETE、MMC_VERB_PROPERTIES等。 启用MMC标准动词 (MSDN))

如果您想显示属性页而不使用MMC的“属性”菜单，则必须使用IPropertySheetProvider来实现。有关详细信息，请参阅后面的“添加向导”部分。 添加属性页 (MSDN)

添加菜单

使用ATL添加菜单非常容易。只需添加一个包含4个弹出菜单的菜单资源。
菜单上的每个弹出菜单都代表MMC弹出菜单中的特定位置。在Top下添加菜单项将创建一个**顶层**菜单，Task - 在**AllTasks**下，New - 在**New**下，View - 在**View**下。要添加菜单，您实际上只需为每个想要菜单命令的节点或结果项使用SNAPINMENUID ATL宏。您使用BEGIN_SNAPINCOMMAND_MAP/END_SNAPINCOMMAND_MAP处理消息。您获得的是CSnapInObjectRootBase的指针。您可以通过查看 m_nType（范围或结果）将其转换为 IComponent或 IComponentData派生类。 添加上下文菜单项 (MSDN)

添加向导

在“所有任务”下添加一个菜单项以调用向导。然后添加一个函数，例如InvokeWizzard，以便在需要时可以访问它。它可以基于m_nType用于结果项和范围项。我们通过菜单命令获得的是CSnapInObjectRoot。请注意，ATL使用了CSnapInObjectRoot中的 m_nType变量。所以我们知道 IComponentDataImpl派生类类型为1， IComponentImpl类型为2。要显示向导，我们必须直接使用IPropertySheetProvider。有关详细信息，请参阅MSDN上的直接使用IPropertySheetProvider。

添加属性页和向导页 (MSDN)

添加工具栏

添加一个包含16x16按钮的工具栏资源。在BEGIN_SNAPINTOOLBARID_MAP/END_SNAPINTOOLBARID_MAP块内添加条目。在BEGIN_SNAPINCOMMAND_MAP/END_SNAPINCOMMAND_MAP下处理来自工具栏的命令。您可以操作工具栏。请注意，CSnapInObjectRootBase有一个CSnapInToolbarInfo的CSimpleMap。将工具栏ID作为键传递给查找方法。它将返回IToolbar指针。现在对其调用SetButtonState。您还可以使用GetToolbarInfo函数获取CSnapInToolbarInfo，然后根据需要遍历类的所有工具栏。更多详细信息请参阅添加工具栏 (MSDN)

添加持久化

如果需要，为 IComponentImpl和/或 IComponentDataImpl实现 IPersistStreamInit。您可以保存节点和项、计算机名称并在下次重新加载它们。 管理单元插件持久化模型 (MSDN)

在添加管理单元插件时添加“连接到服务器”对话框

主静态节点必须响应QueryPagesFor并检查类型是否为CCT_SNAPIN_MANAGER。实现CreatePropertyPages。这样，当MMC添加您的管理单元插件时，您就可以呈现一个选择计算机对话框。该对话框的布局对于大多数组件来说都是标准的。

添加ActiveX控件

添加ActiveX也不难。派生另一个CBaseNodeItem类并实现GetResultViewType。MMC将调用此函数。其中一个参数是ppViewType，它应该设置为您要显示的控件的CLSID。您可以通过pViewOptions参数缓存或每次选择项时重新创建控件。您可以使用MMC_VIEW_OPTIONS_CREATENEW/MMC_VIEW_OPTIONS_NONE。在GetResultViewType返回后，MMC将向管理单元插件发送一个MMCN_INITOCX通知。其中一个参数将是指向IUnknown的指针。当您收到MMC的MMCN_SHOW通知时，您也可以通过IConsole2::QueryResultView获取指针。如果需要，您可以设置您的接收器以接收事件。该控件很可能必须支持IDispatch，但我不能确定，也没有测试过。

使用自定义OCX控件：实现细节 (MSDN)

添加任务板

有两种不同的任务板。管理单元插件任务板和控制台任务板。后者在1.2版本中可用，并且要容易得多，因为MMC负责管理和创建任务板。要添加控制台任务板，请执行以下操作：选择然后右键单击节点。选择新建任务板视图：

您可以尝试不同的选项来更改任务板的外观等...
如果您想手动执行（管理单元插件任务板）或必须支持1.1，请阅读：使用任务板 (MSDN)和使用任务板：实现细节。当然，如果您选择使用管理单元插件任务板，您将对任务板有更多的控制权。

添加网页

查看使用自定义网页 (MSDN)

一些有用的链接