HrOpenABEntryWithExchangeContext

Aplica-se a: Outlook 2013 | Outlook 2016

Abre o entryID usando o Exchange Address Book identificado por pEmsmdbUID. Essa função funciona de forma semelhante a IAddrBook::D etails , exceto que o uso dessa função garante que o IAddrBook::OpenEntry seja aberto usando o provedor de catálogo de endereços do Exchange esperado.

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

HRESULT HrDoABDetailsWithExchangeContext(
  LPMAPISESSION pmsess,
  const MAPIUID *pEmsmdbUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags
);

Parâmetros

pmsess

[in] O registrado no IMAPISession. Não pode ser NULL.

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.

ulFlags

[in] Um bitmask de sinalizadores que controla 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

Usa 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

Usa 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 usa 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.