IAddrBook::CompareEntryIDs
S’applique à : Outlook 2013 | Outlook 2016
Compare deux identificateurs d’entrée qui appartiennent à un fournisseur de carnet d’adresses particulier pour déterminer s’ils font référence au même objet de carnet d’adresses.
HRESULT CompareEntryIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Paramètres
cbEntryID1
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID1 .
lpEntryID1
[in] Pointeur vers le premier identificateur d’entrée à comparer.
cbEntryID2
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID2 .
lpEntryID2
[in] Pointeur vers le deuxième identificateur d’entrée à comparer.
ulFlags
[in] R�serv� ; doit �tre �gal � z�ro.
lpulResult
[out] Pointeur vers le résultat de la comparaison. Le contenu de lpulResult est défini sur TRUE si les deux identificateurs d’entrée font référence au même objet ; sinon, le contenu est défini sur FALSE.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_UNKNOWN_ENTRYID
Un ou les deux identificateurs d’entrée passés avec les paramètres lpEntryID1 ou lpEntryID2 ne sont reconnus par aucun fournisseur de carnet d’adresses.
Remarques
Les applications clientes et les fournisseurs de services appellent la méthode CompareEntryIDs pour comparer deux identificateurs d’entrée appartenant à un seul fournisseur de carnet d’adresses afin de déterminer s’ils font référence au même objet. CompareEntryIDs est utile, car un objet peut avoir plusieurs identificateurs d’entrée valides. Cette situation peut se produire, par exemple, après l’installation d’une nouvelle version d’un fournisseur de carnet d’adresses.
MAPI transmet cet appel au fournisseur de carnet d’adresses responsable des identificateurs d’entrée, en déterminant le fournisseur approprié en faisant correspondre la structure MAPIUID dans les identificateurs d’entrée à la structure MAPIUID inscrite par le fournisseur.
Si les deux identificateurs d’entrée font référence au même objet, CompareEntryIDs définit le contenu du paramètre lpulResult sur TRUE ; s’ils font référence à différents objets, CompareEntryIDs définit le contenu sur FALSE. Dans les deux cas, CompareEntryIDs retourne S_OK. Si CompareEntryIDs retourne une erreur, qui peut se produire si aucun fournisseur de carnet d’adresses n’a inscrit une structure MAPIUID qui correspond à celle des identificateurs d’entrée, les clients et les fournisseurs ne doivent pas effectuer d’action basée sur le résultat de la comparaison. Ils devraient plutôt adopter l’approche la plus conservatrice de l’action en cours.