Compartilhar via

IMSLogon::CompareEntryIDs

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Compara dois identificadores de entrada para determinar se eles se referem ao mesmo objeto. O MAPI encaminha essa chamada a um provedor de serviços somente se os identificadores exclusivos (UIDs) em ambos os identificadores de entrada a serem comparados forem tratados por esse provedor.

HRESULT CompareEntryIDs(
  ULONG cbEntryID1,
  LPENTRYID lpEntryID1,
  ULONG cbEntryID2,
  LPENTRYID lpEntryID2,
  ULONG ulFlags,
  ULONG FAR * lpulResult
);

Parâmetros

cbEntryID1

[in] O tamanho, em bytes, do identificador de entrada apontado pelo parâmetro lpEntryID1.

lpEntryID1

[in] Um ponteiro para o primeiro identificador de entrada a ser comparado.

cbEntryID2

[in] O tamanho, em bytes, do identificador de entrada apontado pelo parâmetro lpEntryID2.

lpEntryID2

[in] Um ponteiro para o segundo identificador de entrada a ser comparado.

ulFlags

[in] Reservados; deve ser zero.

lpulResult

[out] Um ponteiro para o resultado retornado da comparação. TRUE se os dois identificadores de entrada se referirem ao mesmo objeto; caso contrário, FALSE.

Valor de retorno

S_OK

A chamada foi bem-sucedida e retornou o valor ou valores esperados.

Comentários

Os provedores do repositório de mensagens implementam o método IMSLogon::CompareEntryIDs para comparar dois identificadores de entrada de uma determinada entrada em um repositório de mensagens para determinar se eles se referem ao mesmo objeto. Se os dois identificadores de entrada se referirem ao mesmo objeto, CompareEntryIDs definirá o parâmetro lpulResult como TRUE; se eles se referirem a objetos diferentes, CompareEntryIDs define lpulResult como FALSE.

CompareEntryIDs é útil porque um objeto pode ter mais de um identificador de entrada válido. Isso pode ocorrer, por exemplo, depois que uma nova versão de um provedor de repositório de mensagens for instalada.

Confira também

IMSLogon : IUnknown