HrOpenABEntryWithProviderUID

Aplica-se a: Outlook 2013 | Outlook 2016

Abre o entryID usando o Exchange Address Book identificado por pEmsabpUID. Essa função funciona de forma semelhante ao IAddrBook::OpenEntry , exceto que o uso dessa função garante que iAddrBook::OpenEntry seja aberto usando o provedor esperado do Exchange Address Book.

Propriedade	Valor
Arquivo de cabeçalho:	abhelp.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

HRESULT HrOpenABEntryWithProviderUID(
  const MAPIUID *pEmsabpUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parâmetros

pEmsmdbUID

[in] Um ponteiro para um emsmdbUID que identifica o Serviço exchange que contém o Provedor de Catálogo de Endereços do Exchange que essa função deve usar para exibir detalhes no identificador de entrada. Se o identificador de entrada de entrada de entrada não for um identificador de entrada do Provedor de Catálogo de Endereços do Exchange, esse parâmetro será ignorado e a chamada de função se comportará como IAddrBook::D etails. Se esse parâmetro for NULL ou um MAPIUID zero, essa função se comportará como IAddrBook::D etails.

pAddrBook

[in] O catálogo de endereços usado para abrir o identificador de entrada. Não pode ser NULL.

cbEntryID

[in] A contagem de bytes do identificador de entrada especificada pelo parâmetro lpEntryID .

Lpentryid

[in] Um ponteiro para o identificador de entrada que representa a entrada do catálogo de endereços a ser aberta.

lpInterface

[in] Um ponteiro para o IID (identificador de interface) da interface usada para acessar a entrada aberta. Passar NULL retorna a interface padrão do objeto. Para usuários de mensagens, a interface padrão é IMailUser : IMAPIProp. Para listas de distribuição, é IDistList : IMAPIContainere para contêineres, é IABContainer : IMAPIContainer. Os chamadores podem definir lpInterface para a interface padrão apropriada ou uma interface na hierarquia de herança.

ulFlags

[in] Um bitmask de sinalizadores que controla a forma como a entrada é aberta, os seguintes sinalizadores podem ser definidos:

MAPI_BEST_ACCESS

Solicita que a entrada seja aberta com as permissões máximas de rede e cliente permitidas. Por exemplo, se o cliente tiver permissão de leitura e gravação, o provedor de catálogo de endereços tentará abrir a entrada com permissão de leitura e gravação. O cliente pode recuperar o nível de acesso concedido chamando o método IMAPIProp::GetProps da entrada aberta e recuperando a propriedade PR_ACCESS_LEVEL (PidTagAccessLevel).

MAPI_CACHE_ONLY

Use apenas o catálogo de endereços offline para executar a resolução de nomes. Por exemplo, você pode usar esse sinalizador para permitir que um aplicativo cliente abra a GAL (lista de endereços global) no modo de troca armazenado em cache e acesse uma entrada no catálogo de endereços do cache sem criar tráfego entre o cliente e o servidor. Esse sinalizador tem suporte apenas pelo Provedor de Catálogo de Endereços do Exchange.

MAPI_DEFERRED_ERRORS

Permite que a chamada tenha êxito, potencialmente antes que a entrada esteja totalmente aberta e disponível, implicando que chamadas subsequentes para a entrada podem retornar um erro.

MAPI_GAL_ONLY

Use apenas o GAL para executar a resolução de nomes. Esse sinalizador tem suporte apenas pelo Provedor de Catálogo de Endereços do Exchange.

MAPI_MODIFY

Solicita que a entrada seja aberta com permissão de leitura e gravação. Como as entradas são abertas com acesso somente leitura por padrão, os clientes não devem assumir que a permissão de leitura e gravação foi concedida independentemente de MAPI_MODIFY está definida.

MAPI_NO_CACHE

Não use o catálogo de endereços offline para executar a resolução de nomes. Esse sinalizador tem suporte apenas pelo Provedor de Catálogo de Endereços do Exchange.

lpulObjType

[out] Um ponteiro para o tipo da entrada aberta.

Lppunk

[out] Um ponteiro para um ponteiro da entrada aberta.