IMAPISupport::SetProviderUID

适用于:Outlook 2013 | Outlook 2016

注册唯一表示服务提供程序的 MAPIUID 结构。

HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);

参数

lpProviderID

[in]指向 MAPIUID 结构的指针,该结构标识通讯簿或消息存储提供程序。

ulFlags

保留;必须为零。

返回值

S_OK

MAPIUID 结构已成功注册。

备注

IMAPISupport::SetProviderUID 方法为通讯簿和消息存储提供程序支持对象实现。 这些提供程序调用 SetProviderUID 来注册 lpProviderID 指向的 MAPIUID 结构中描述的唯一标识符。 提供程序将此标识符包含在他们创建的所有条目标识符中。

当 MAPI 将出站消息发送到 MAPI 后台处理程序并确定用于处理客户端请求的相应提供程序时,MAPI 使用 MAPIUID 结构。 例如,当客户端调用 IMAPISession::OpenEntry 方法时,MAPI 检查条目标识符的 MAPIUID 部分,将其映射到将其传递给 SetProviderUID 的提供程序,并调用该提供程序的 OpenEntry

给调用方的说明

在登录时调用 SetProviderUID 以注册 MAPIUID 结构。 MAPI 允许通讯簿和消息存储提供程序注册多个标识符。 对 SetProviderUID 进行多次调用时,它始终会将 MAPIUID 结构添加到提供程序的 MAPIUID 结构集,即使 MAPIUID 是重复的也是如此。 SetProviderUID 无法删除 MAPIUID

另请参阅

MAPIUID

IMAPISupport : IUnknown