IAddrBook::CompareEntryIDs
Aplica-se a: Outlook 2013 | Outlook 2016
Compara dois identificadores de entrada que pertencem a um provedor de catálogo de endereços específico para determinar se eles se referem ao mesmo objeto do catálogo de endereços.
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. O conteúdo de lpulResult será definido como TRUE se os dois identificadores de entrada se referirem ao mesmo objeto; caso contrário, o conteúdo é definido como FALSE.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_UNKNOWN_ENTRYID
Um ou ambos os identificadores de entrada passados com os parâmetros lpEntryID1 ou lpEntryID2 não são reconhecidos por nenhum provedor de catálogo de endereços.
Comentários
Aplicativos cliente e provedores de serviços chamam o método CompareEntryIDs para comparar dois identificadores de entrada que pertencem a um único provedor de catálogo de endereços para determinar se eles se referem ao mesmo objeto. 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 catálogo de endereços for instalada.
O MAPI passa essa chamada para o provedor de catálogo de endereços responsável pelos identificadores de entrada, determinando o provedor apropriado, correspondendo à estrutura MAPIUID nos identificadores de entrada com a estrutura MAPIUID registrada pelo provedor.
Se os dois identificadores de entrada se referirem ao mesmo objeto, CompareEntryIDs definirá o conteúdo do parâmetro lpulResult como TRUE; se eles se referirem a objetos diferentes, CompareEntryIDs define o conteúdo como FALSE. Em ambos os casos, CompareEntryIDs retorna S_OK. Se CompareEntryIDs retornar um erro, que pode ocorrer se nenhum provedor de catálogo de endereços tiver registrado uma estrutura MAPIUID que corresponda à dos identificadores de entrada, clientes e provedores não devem tomar nenhuma ação com base no resultado da comparação. Em vez disso, eles devem adotar a abordagem mais conservadora para a ação que está sendo executada.