IDXCoreAdapterFactory::UnregisterEventNotification, méthode

Annule l’inscription à partir d’une notification pour laquelle vous avez précédemment inscrit. Pour obtenir des conseils de programmation et des exemples de code, consultez Utilisation de DXCore pour énumérer des 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 codeHRESULTerror.

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 une fois l’enregistrement UnregisterEventNotification retourné. Toutefois, pour éviter un interblocage, si vous appelez UnregisterEventNotification à partir de votre rappel, UnregisterEventNotification n’attend pas que le rappel actif se termine.

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 est alors éligible pour être retournée par une inscription ultérieure

Voir aussi

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