Метод IDXCoreAdapterFactory::UnregisterEventNotification
Отменяет регистрацию в уведомлении, которое вы ранее зарегистрировали. Рекомендации по программированию и примеры кода см. в статье Использование DXCore для перечисления адаптеров.
Синтаксис
virtual HRESULT STDMETHODCALLTYPE UnregisterEventNotification(
uint32_t eventCookie) = 0;
Параметры
eventCookie
Тип: uint32_t
Значение файла cookie (возвращаемое при вызове IDXCoreAdapterFactory::RegisterEventNotification), представляющее предварительную регистрацию, для которой теперь требуется отменить регистрацию.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибкиHRESULT.
Возвращаемое значение | Описание |
---|---|
E_INVALIDARG | Значение eventCookie не является допустимым файлом cookie, представляющим предварительную регистрацию. |
Комментарии
UnregisterEventNotification возвращается только после завершения всех ожидающих и выполняющихся обратных вызовов для этой регистрации. DXCore гарантирует, что после возврата unregisterEventNotification новые обратные вызовы для этой регистрации не будут выполняться. Однако, чтобы избежать взаимоблокировки, при вызове UnregisterEventNotification из обратного вызова UnregisterEventNotification не будет ожидать завершения активного обратного вызова.
Важно!
Перед уничтожением объекта DXCore, представленного аргументом dxCoreObject , переданным в IDXCoreAdapterFactory::RegisterEventNotification, необходимо использовать значение файла cookie, чтобы отменить регистрацию этого объекта в уведомлениях, вызвав UnregisterEventNotification. Если этого не сделать, при обнаружении ситуации возникает неустранимое исключение.
После отмены регистрации значения файла cookie это значение может быть возвращено последующей регистрацией.
См. также раздел
IDXCoreAdapter, IDXCoreAdapterList, IDXCoreAdapterFactory::UnregisterEventNotification, DXCore Reference, Использование DXCore для перечисления адаптеров
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по