IDXCoreAdapterFactory：：UnregisterEventNotification 方法

  • 發行項

從您先前註冊的通知取消註冊。 如需程式設計指引和程式碼範例，請參閱 使用 DXCore 列舉配接器。

語法

virtual HRESULT STDMETHODCALLTYPE UnregisterEventNotification(
  uint32_t eventCookie) = 0;

參數

eventCookie

類型： uint32_t

當您呼叫 IDXCoreAdapterFactory：：RegisterEventNotification) 代表您現在要取消註冊的先前註冊時， (傳回的 Cookie 值。

傳回

類型： HRESULT

如果函式成功，它會 傳回S_OK。 否則，它會傳回 HRESULT錯誤碼。

傳回值 描述
E_INVALIDARG eventCookie的值不是代表先前註冊的有效 Cookie。

備註

只有在完成此註冊的所有擱置/進行中回呼之後，UnregisterEventNotification才會傳回。 DXCore 保證 在傳回 UnregisterEventNotification 之後，此註冊不會發生任何新的回呼。 不過，若要避免死結，如果您從回呼內呼叫 UnregisterEventNotification ， 則 UnregisterEventNotification 不會等待作用中的回呼完成。

重要

在您終結傳遞至IDXCoreAdapterFactory：：RegisterEventNotification的dxCoreObject引數所代表的 DXCore 物件之前，您必須呼叫UnregisterEventNotification，使用 Cookie 值從通知取消註冊該物件。 如果您未這麼做，則會在偵測到情況時引發嚴重例外狀況。

一旦您取消註冊 Cookie 值，該值便符合後續註冊傳回的資格

另請參閱

IDXCoreAdapter、IDXCoreAdapterList、IDXCoreAdapterFactory：：UnregisterEventNotification、DXCore 參考、使用 DXCore 列舉配接器