IMsgServiceAdmin::AdminProviders

适用于:Outlook 2013 | Outlook 2016

返回一个指针,该指针提供对提供程序管理对象的访问。

HRESULT AdminProviders(
  LPMAPIUID lpUID,
  ULONG ulFlags,
  LPPROVIDERADMIN FAR * lppProviderAdmin
);

参数

lpUID

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

ulFlags

[in]始终为 NULL。

lppProviderAdmin

[out]指向提供程序管理对象的指针的指针。

返回值

S_OK

已成功返回提供程序管理对象。

MAPI_E_NOT_FOUND

lpUID 指向的 MAPIUID 不存在。

备注

IMsgServiceAdmin::AdminProviders 方法提供对提供程序管理对象的访问权限。 提供程序管理是一个对象,它支持 IProviderAdmin 接口,并使客户端能够执行以下操作:

  • 将服务提供程序添加到消息服务。

  • 从消息服务中删除服务提供程序。

  • 打开配置文件部分。

  • 访问消息服务提供程序表。

在使用配置文件时,实际可以对消息服务进行的更改类型取决于消息服务。 但是,大多数消息服务不支持更改,例如在使用配置文件时添加和删除提供程序。

给调用方的说明

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

MFCMAPI 引用

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

文件 函数 Comment
MsgServiceTableDlg.cpp
CMsgServiceTableDlg::OnDisplayItem
MFCMAPI 使用 IMsgServiceAdmin::AdminProviders 方法打开服务的提供程序管理对象。

另请参阅

IProviderAdmin : IUnknown

MAPIUID

IMsgServiceAdmin : IUnknown

MFCMAPI 代码示例