IMsgStore::CompareEntryIDs

Artigo
04/04/2023

Aplica-se a: Outlook 2013 | Outlook 2016

Compara dois identificadores de entrada para determinar se eles se referem à mesma entrada em um repositório de mensagens. O MAPI passa essa chamada para 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] A contagem de bytes no identificador de entrada apontada pelo parâmetro lpEntryID1.

lpEntryID1

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

cbEntryID2

[in] A contagem de bytes no identificador de entrada apontada 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 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 comparação foi bem-sucedida.

MAPI_E_UNKNOWN_ENTRYID

Um ou ambos os identificadores de entrada especificados como parâmetros não se referem a objetos, possivelmente porque os objetos correspondentes estão abertos e indisponíveis no momento.

Comentários

O método IMsgStore::CompareEntryIDs compara dois identificadores de entrada que pertencem ao repositório de mensagens para determinar se eles se referem ao mesmo objeto.

Notas para chamadores

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

Se CompareEntryIDs retornar um erro, não tome nenhuma ação com base no resultado da comparação. Em vez disso, tome a abordagem mais conservadora possível. CompareEntryIDs pode falhar se, por exemplo, um ou ambos os identificadores de entrada contiver um MAPIUID inválido.