IMsgServiceAdmin::SetPrimaryIdentity
适用于:Outlook 2013 | Outlook 2016
将消息服务指定为配置文件的主要标识的供应商。
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
参数
lpUID
[in]指向 MAPIUID 结构的指针,该结构包含用于提供主要标识的消息服务的唯一标识符,或 NULL,指示 SetPrimaryIdentity 应清除当前标识。
ulFlags
[in]保留;必须为零。
返回值
S_OK
已成功为消息服务分配主要标识的供应商。
MAPI_E_NO_ACCESS
SetPrimaryIdentity 尝试指定在其PR_RESOURCE_FLAGS (PidTagResourceFlags) 属性中设置了SERVICE_NO_PRIMARY_IDENTITY标志的消息服务。
备注
IMsgServiceAdmin::SetPrimaryIdentity 方法将消息服务建立为配置文件的主要标识的供应商。 主要标识通常是登录到消息服务的用户。 它由三个属性表示:
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
指定消息服务中的每个服务提供程序将这三个属性设置为提供主标识的消息用户的显示名称、条目标识符和搜索键。 客户端可以通过调用 IMAPISession::QueryIdentity 方法检索主标识的条目标识符。
PR_RESOURCE_FLAGS 属性设置为STATUS_PRIMARY_IDENTITY作为提供主标识的消息服务成员的每个提供程序,并设置为消息服务的SERVICE_PRIMARY_IDENTITY。 当服务提供商无法为其消息服务提供主标识时,它会将 PR_RESOURCE_FLAGS 设置为STATUS_NO_PRIMARY_IDENTITY。 SetPrimaryIdentity 设置未向 SERVICE_NO_PRIMARY_IDENTITY 提供主标识的每个消息服务的 PR_RESOURCE_FLAGS 属性。
当客户端登录到服务时,MAPI 具有相关信息的每个消息服务提供程序都可以为其每个用户建立标识。 但是,由于 MAPI 支持为每个 MAPI 会话连接到多个服务提供商,因此对于 MAPI 会话整体的特定用户标识没有明确定义:用户的标识取决于涉及的服务。 客户端可以调用 SetPrimaryIdentity ,以指定消息服务为用户建立的众多标识之一作为该用户的主要标识。