IMAPISupport::CompareEntryIDs
S’applique à : Outlook 2013 | Outlook 2016
Compare deux identificateurs d’entrée pour déterminer s’ils font référence au même objet.
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. TRUE si les deux identificateurs d’entrée font référence au même objet ; sinon, FALSE.
Valeur renvoyée
S_OK
La comparaison a réussi.
MAPI_E_UNKNOWN_ENTRYID
Un ou les deux identificateurs d’entrée spécifiés en tant que paramètres ne font pas référence à des objets valides, peut-être parce qu’ils sont actuellement non ouverts et indisponibles.
Remarques
La méthode IMAPISupport ::CompareEntryIDs est implémentée pour les objets de prise en charge du carnet d’adresses et du fournisseur de magasin de messages. CompareEntryIDs compare deux identificateurs d’entrée qui appartiennent à un seul fournisseur de services pour déterminer s’ils font référence au même objet. MAPI extrait la partie MAPIUID des identificateurs d’entrée pour déterminer le fournisseur de services responsable des objets. MAPI appelle ensuite la méthode CompareEntryIDs de son objet d’ouverture de session pour effectuer la comparaison.
Remarques pour les appelants
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 services.
Si CompareEntryIDs retourne une erreur, n’effectuez aucune action basée sur le résultat de la comparaison. Au lieu de cela, prenez l’approche la plus conservatrice possible. CompareEntryIDs peut échouer si, par exemple, l’un des identificateurs d’entrée ou les deux contiennent une structure MAPIUID non valide.