Partager via

IMSProvider::CompareStoreIDs

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Compare deux identificateurs d’entrée de magasin de messages pour déterminer s’ils font référence au même objet de magasin.

HRESULT CompareStoreIDs(
  ULONG cbEntryID1,
  LPENTRYID lpEntryID1,
  ULONG cbEntryID2,
  LPENTRYID lpEntryID2,
  ULONG ulFlags,
  ULONG FAR * lpulResult
);

Paramètres

cbEntryID1

[in] Taille, en octets, de l’identificateur d’entrée désigné par le paramètre lpEntryID1.

lpEntryID1

[in] Pointeur vers le premier identificateur d’entrée à comparer.

cbEntryID2

[in] Taille, en octets, de l’identificateur d’entrée désigné par 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 retourné 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

L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.

Remarques

MAPI appelle la méthode IMSProvider ::CompareStoreIDs quand il traite un appel à la méthode IMAPISession ::OpenMsgStore . CompareStoreIDs est appelé à ce stade pour déterminer quelle section de profil, le cas échéant, est associée à la banque de messages en cours d’ouverture. Un appel CompareStoreIDs peut être effectué lorsqu’aucune banque de messages n’est ouverte pour un fournisseur de magasin particulier. En outre, MAPI appelle également CompareStoreIDs lorsqu’il traite un appel de fournisseur de magasin à la méthode IMAPISupport ::OpenProfileSection .

Les identificateurs d’entrée comparés par CompareStoreID sont à la fois pour la bibliothèque de liens dynamiques (DLL) du fournisseur de magasin actuel et sont tous deux des identificateurs d’entrée de magasin non empaquetés. Pour plus d’informations sur l’encapsulation des identificateurs d’entrée de magasin, consultez IMAPISupport ::WrapStoreEntryID.

La comparaison des identificateurs d’entrée est utile, car un objet peut avoir plusieurs identificateurs d’entrée valides. Cela peut se produire, par exemple, après l’installation d’une nouvelle version d’un fournisseur de magasin de messages.

Voir aussi

IMAPISession::OpenMsgStore

IMAPISupport::OpenProfileSection

IMAPISupport::WrapStoreEntryID

IMSProvider : IUnknown