IMsgServiceAdmin::SetPrimaryIdentity
Aplica-se a: Outlook 2013 | Outlook 2016
Designa um serviço de mensagem para ser o fornecedor da identidade primária do perfil.
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
Parâmetros
lpUID
[in] Um ponteiro para a estrutura MAPIUID que contém o identificador exclusivo para o serviço de mensagem fornecer a identidade primária ou NULL, o que indica que SetPrimaryIdentity deve limpar a identidade atual.
ulFlags
[in] Reservados; deve ser zero.
Valor de retorno
S_OK
O serviço de mensagem foi atribuído com êxito ao fornecedor da identidade primária.
MAPI_E_NO_ACCESS
SetPrimaryIdentity tentou designar um serviço de mensagem que tem o sinalizador SERVICE_NO_PRIMARY_IDENTITY definido em sua propriedade PR_RESOURCE_FLAGS (PidTagResourceFlags).
Comentários
O método IMsgServiceAdmin::SetPrimaryIdentity estabelece um serviço de mensagem como o fornecedor da identidade primária para o perfil. A identidade primária normalmente é o usuário conectado ao serviço de mensagem. Ela é representada por três propriedades:
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
Cada provedor de serviços no serviço de mensagem designado define essas três propriedades como o nome de exibição, o identificador de entrada e a chave de pesquisa do usuário de mensagens que fornece a identidade primária. Os clientes podem recuperar o identificador de entrada da identidade primária chamando o método IMAPISession::QueryIdentity .
A propriedade PR_RESOURCE_FLAGS está definida como STATUS_PRIMARY_IDENTITY para cada provedor que é membro do serviço de mensagem que fornece a identidade primária e para SERVICE_PRIMARY_IDENTITY para o serviço de mensagem. Quando um provedor de serviços não pode fornecer a identidade primária para seu serviço de mensagens, ele define PR_RESOURCE_FLAGS como STATUS_NO_PRIMARY_IDENTITY. SetPrimaryIdentity define a propriedade PR_RESOURCE_FLAGS de cada serviço de mensagem que não está fornecendo a identidade primária para SERVICE_NO_PRIMARY_IDENTITY.
Cada provedor de serviços de mensagem sobre o qual o MAPI tem informações pode estabelecer uma identidade para cada um de seus usuários quando um cliente faz logon no serviço. No entanto, como o MAPI dá suporte a conexões com vários provedores de serviços para cada sessão MAPI, não há uma definição firme da identidade de um determinado usuário para a sessão MAPI como um todo; A identidade de um usuário depende de qual serviço está envolvido. Os clientes podem chamar SetPrimaryIdentity para designar uma das muitas identidades estabelecidas para um usuário por serviços de mensagem como a identidade primária desse usuário.