Méthode IDXCoreAdapterFactory::UnregisterEventNotification

Annule l’inscription à partir d’une notification pour laquelle vous vous êtes inscrit précédemment. Pour obtenir des conseils de programmation et des exemples de code, consultez Utilisation de DXCore pour énumérer les adaptateurs.

Syntaxe

virtual HRESULT STDMETHODCALLTYPE UnregisterEventNotification(
  uint32_t eventCookie) = 0;

Paramètres

eventCookie

Type : uint32_t

Valeur de cookie (retournée lorsque vous avez appelé IDXCoreAdapterFactory::RegisterEventNotification) représentant une inscription antérieure pour laquelle vous souhaitez maintenant annuler l’inscription.

Retours

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreurHRESULT.

Valeur retournée	Description
E_INVALIDARG	La valeur d’eventCookie n’est pas un cookie valide représentant une inscription préalable.

Notes

UnregisterEventNotification retourne uniquement une fois que tous les rappels en attente/en cours pour cette inscription sont terminés. DXCore garantit qu’aucun nouveau rappel ne se produira pour cette inscription après le retour de UnregisterEventNotification . Toutefois, pour éviter un blocage, si vous appelez UnregisterEventNotification à partir de votre rappel, UnregisterEventNotification n’attend pas la fin du rappel actif.

Important

Avant de détruire l’objet DXCore représenté par l’argument dxCoreObject passé à IDXCoreAdapterFactory::RegisterEventNotification, vous devez utiliser la valeur de cookie pour désinscrire cet objet des notifications en appelant UnregisterEventNotification. Si vous ne le faites pas, une exception irrécupérable est levée lorsque la situation est détectée.

Une fois que vous annulez l’inscription d’une valeur de cookie, cette valeur peut être retournée par une inscription suivante

Voir aussi

IDXCoreAdapter, IDXCoreAdapterList, IDXCoreAdapterFactory::UnregisterEventNotification, Référence DXCore, Utilisation de DXCore pour énumérer les adaptateurs