HrOpenABEntryUsingDefaultContext

Aplica-se a: Outlook 2013 | Outlook 2016

Executa a mesma função que HrOpenABEntryWithExchangeContext , exceto que ela usa o emsmdbUID herdado como o parâmetro pEmsmdbUID . Não use essa função a menos que você não possa obter o emsmdbUID correto para a chamada para HrOpenABEntryWithExchangeContext.

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

HRESULT HrOpenABEntryUsingDefaultContext(
  LPMAPISESSION pmsess,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parâmetros

pmsess

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

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, ele é IDistList : IMAPIContainer e 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 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 é compatível apenas com o 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 é compatível apenas com o 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 é compatível apenas com o 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.