IMAPISession::CompareEntryIDs
Aplica-se a: Outlook 2013 | Outlook 2016
Compara dois identificadores de entrada para determinar se eles se referem ao mesmo objeto.
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 esses objetos estão abertos e indisponíveis no momento.
Comentários
O método IMAPISession::CompareEntryIDs compara dois identificadores de entrada que pertencem a um único provedor de serviços para determinar se eles se referem ao mesmo objeto. O MAPI extrai a parte MAPIUID dos identificadores de entrada para determinar o provedor de serviços responsável pelos objetos e, em seguida, chama o método CompareEntryIDs do objeto logon para executar a comparação.
Notas para chamadores
O método CompareEntryIDs é útil porque um objeto pode ter mais de um identificador de entrada válido. Essa situação pode ocorrer, por exemplo, depois que uma nova versão de um provedor de serviços 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 contiverem um MAPIUID inválido.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| BaseDialog.cpp |
CbaseDialog::OnCompareEntryIDs |
O MFCMAPI usa o método IMAPISession::CompareEntryIDs para comparar duas IDs de entrada que um usuário insere. |