IMsgStore::CompareEntryIDs

Article
03/15/2024

S’applique à : Outlook 2013 | Outlook 2016

Compare deux identificateurs d’entrée pour déterminer s’ils font référence à la même entrée dans une banque de messages. MAPI transmet cet appel à un fournisseur de services uniquement si les identificateurs uniques (UID) dans les deux identificateurs d’entrée à comparer sont gérés par ce fournisseur.

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 aux objets, peut-être parce que les objets correspondants ne sont pas ouverts et ne sont pas disponibles actuellement.

Remarques

La méthode IMsgStore ::CompareEntryIDs compare deux identificateurs d’entrée qui appartiennent à la banque de messages pour déterminer s’ils font référence au même objet.

Remarques pour les appelants

CompareEntryIDs est utile, car un objet peut avoir plusieurs identificateurs d’entrée valides (par exemple, après l’installation d’une nouvelle version d’un fournisseur de magasin de messages).

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.