IDXCoreAdapterFactory::UnregisterEventNotification-Methode
Aufheben der Registrierung bei einer Benachrichtigung, für die Sie sich zuvor registriert haben. Programmieranleitungen und Codebeispiele finden Sie unter Using DXCore to enumerate adapters(Verwenden von DXCore zum Aufzählen von Adaptern).
Syntax
virtual HRESULT STDMETHODCALLTYPE UnregisterEventNotification(
uint32_t eventCookie) = 0;
Parameter
eventCookie
Typ: uint32_t
Der Cookiewert (zurückgegeben beim Aufrufen von IDXCoreAdapterFactory::RegisterEventNotification),der eine vorherige Registrierung darstellt, für die Sie die Registrierung aufheben möchten.
Rückgabe
Typ: HRESULT
Wenn die Funktion erfolgreich ist, gibt sie S_OK. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
| Rückgabewert | BESCHREIBUNG |
|---|---|
| E_INVALIDARG | Der Wert von eventCookie ist kein gültiges Cookie, das eine vorherige Registrierung darstellt. |
Bemerkungen
UnregisterEventNotification wird erst zurückgegeben, nachdem alle ausstehenden/in Bearbeitungen ausstehenden Rückrufe für diese Registrierung abgeschlossen wurden. DXCore garantiert, dass für diese Registrierung keine neuen Rückrufe erfolgen, nachdem UnregisterEventNotification zurückgegeben wurde. Wenn Sie jedoch UnregisterEventNotification innerhalb Ihres Rückrufs aufrufen, wartet UnregisterEventNotification nicht auf den Abschluss des aktiven Rückrufs, um einen Deadlock zu vermeiden.
Wichtig
Bevor Sie das DXCore-Objekt zerstören, das durch das dxCoreObject-Argument dargestellt wird, das an IDXCoreAdapterFactory::RegisterEventNotificationübergeben wird, müssen Sie den Cookiewert verwenden, um die Registrierung dieses Objekts bei Benachrichtigungen durch Aufrufen von UnregisterEventNotification aufheben. Wenn Sie dies nicht tun, wird eine schwerwiegende Ausnahme ausgelöst, wenn die Situation erkannt wird.
Nachdem Sie die Registrierung eines Cookiewerts aufgehoben haben, kann dieser Wert von einer nachfolgenden Registrierung zurückgegeben werden.
Weitere Informationen
IDXCoreAdapter, IDXCoreAdapterList, IDXCoreAdapterFactory::UnregisterEventNotification, DXCore-Referenz, Verwenden von DXCore zum Aufzählen von Adaptern