Функция FwpmFilterSubscribeChanges0 (fwpmu.h)

Функция FwpmFilterSubscribeChanges0 используется для запроса доставки уведомлений об изменениях в определенном фильтре.

Синтаксис

DWORD FwpmFilterSubscribeChanges0(
  [in]           HANDLE                          engineHandle,
  [in]           const FWPM_FILTER_SUBSCRIPTION0 *subscription,
  [in]           FWPM_FILTER_CHANGE_CALLBACK0    callback,
  [in, optional] void                            *context,
  [out]          HANDLE                          *changeHandle
);

Параметры

[in] engineHandle

Тип: HANDLE

Дескриптор открытого сеанса для подсистемы фильтрации. Вызовите FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.

[in] subscription

Тип: FWPM_FILTER_SUBSCRIPTION0*

Доставляемые уведомления.

[in] callback

Тип: FWPM_FILTER_CHANGE_CALLBACK0

Указатель функции, который будет вызываться, когда уведомление будет готово к доставке.

[in, optional] context

Тип: void*

Необязательный указатель контекста. Этот указатель передается в функцию обратного вызова вместе со сведениями об изменении.

[out] changeHandle

Тип: HANDLE*

Дескриптор для только что созданной подписки.

Возвращаемое значение

Тип: DWORD

Комментарии

Подписчики не получают уведомления об изменениях, внесенных с помощью того же дескриптора сеанса, который используется для подписки. Это связано с тем, что подписчики должны видеть только изменения, внесенные другими пользователями, так как они уже знают, какие изменения они внесли сами.

Эту функцию нельзя вызвать из транзакции. При FWP_E_TXN_IN_PROGRESS произойдет сбой. Дополнительные сведения о транзакциях см. в разделе Управление объектами.

Вызывающему объекту требуется FWPM_ACTRL_SUBSCRIBE доступ к контейнеру фильтра и FWPM_ACTRL_READ доступ к фильтру. Подписчик будет получать уведомления только о фильтрах, к которым у него есть FWPM_ACTRL_READ доступ. Дополнительные сведения см. в разделе контроль доступа.

FwpmFilterSubscribeChanges0 — это конкретная реализация FwpmFilterSubscribeChanges. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Требования

См. также раздел

FWPM_FILTER_CHANGE_CALLBACK0

FWPM_FILTER_SUBSCRIPTION0

FwpmFilterUnsubscribeChanges0