IMsgServiceAdmin::DeleteMsgService

适用于:Outlook 2013 | Outlook 2016

从配置文件中删除消息服务。

HRESULT DeleteMsgService(
  LPMAPIUID lpuid
);

参数

lpuid

[in]指向 MAPIUID 结构的指针,该结构包含要删除的消息服务的唯一标识符。

返回值

S_OK

消息服务已删除。

MAPI_E_NOT_FOUND

lpuid 指向的 MAPIUID 与现有消息服务不匹配。

备注

IMsgServiceAdmin::D eleteMsgService 方法从配置文件中删除消息服务。 DeleteMsgService 删除与消息服务相关的所有配置文件部分。

DeleteMsgService 执行以下步骤来删除消息服务:

  1. 在删除配置文件部分之前,调用消息服务的入口点函数,并将 ulContext 参数设置为 MSG_SERVICE_DELETE。 这允许服务执行任何特定于服务的任务。

  2. 删除消息服务。

  3. 删除消息服务的配置文件部分。

删除服务后,不会再次调用消息服务的入口点函数。

给调用方的说明

若要检索要删除的消息服务的 MAPIUID 结构,请从消息服务表中的消息服务的行中检索 PR_SERVICE_UID (PidTagServiceUid) 属性列。 有关详细信息,请参阅 IMsgServiceAdmin::CreateMsgService 方法中概述的过程。

MFCMAPI 引用

有关 MFCMAPI 示例代码,请参阅下表。

文件 函数 Comment
MsgServiceTableDlg.cpp
CMsgServiceTableDlg::OnDeleteSelectedItem
MFCMAPI 使用 IMsgServiceAdmin::D eleteMsgService 方法删除所选服务。

另请参阅

MAPIUID

IMsgServiceAdmin : IUnknown

MFCMAPI 代码示例