IMAPISession::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
L’un ou les deux identificateurs d’entrée spécifiés en tant que paramètres ne font pas référence à des objets, peut-être parce que ces objets ne sont actuellement pas ouverts et indisponibles.
Remarques
La méthode IMAPISession ::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, puis appelle la méthode CompareEntryIDs de son objet d’ouverture de session pour effectuer la comparaison.
Remarques pour les appelants
La méthode 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 un MAPIUID non valide.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| BaseDialog.cpp |
CbaseDialog ::OnCompareEntryIDs |
MFCMAPI utilise la méthode IMAPISession ::CompareEntryIDs pour comparer deux ID d’entrée entrés par un utilisateur. |