Partager via


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.

Voir aussi

MAPIUID

IMAPISupport : IUnknown