Функция FwpmDynamicKeywordSubscribe0 (fwpmu.h)
Запрашивает доставку уведомлений об изменениях конкретных объектов динамического адреса ключевое слово (FW_DYNAMIC_KEYWORD_ADDRESS0). В зависимости от переданного флага уведомления можно создавать только для подмножества адресов.
Дополнительные сведения и примеры кода см. в разделе Динамические ключевые слова брандмауэра.
Синтаксис
DWORD FwpmDynamicKeywordSubscribe0(
DWORD flags,
FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
void *context,
HANDLE *subscriptionHandle
);
Параметры
flags
Тип: _In_ DWORD
Следующие флаги определены в fwpmu.h.
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE указывает, что уведомления будут доставляться только для объектов, для которых установлен флаг FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE .
FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE указывает, что уведомления будут доставляться только для объектов, для которых не задан флаг FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE .
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE указывает, что уведомления будут доставляться для всех динамических объектов адреса ключевое слово.
callback
Тип: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0
Указатель на реализуемую функцию обратного вызова, которая будет вызываться, когда уведомление будет готово к доставке.
context
Тип: _In_opt_ void*
Необязательный указатель контекста. Этот указатель передается в функцию обратного вызова.
subscriptionHandle
Тип: _Out_ HANDLE*
Адрес дескриптора, который заполняется дескриптором для созданной подписки.
Возвращаемое значение
Тип: DWORD
Если функция выполняется успешно, она возвращает ERROR_SUCCESS. В противном случае возвращается одно из следующих значений.
| Возвращаемое значение | Описание |
|---|---|
| ERROR_INVALID_PARAMETER | Значение флагов равно нулю. |
Комментарии
При добавлении или удалении объекта доставляются уведомления для динамических адресов ключевое слово автоотрезолирования.
Уведомления для динамических ключевое слово адресов, не относящихся к autoResolve, доставляются при добавлении, удалении или обновлении объекта.
Функция обратного вызова не предоставляет никаких данных. Вы можете использовать API перечисления , если вам нужны сведения об изменениях в системе.
Вы несете ответственность за закрытие дескриптора, если подписка вам больше не нужна. Для этого необходимо вызвать функцию FwpmDynamicKeywordUnsubscribe0 .
Реализация FWPM_DYNAMIC_KEYWORD_CALLBACK0 должна быстро реагировать на изменения в динамических ключевое слово адресных объектов, так как она запланирована в потоке ThreadPool и может повлиять на другие операции ожидания.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | сборка Windows 10 20348 |
| Минимальная версия сервера | сборка Windows 10 20348 |
| Целевая платформа | Windows |
| Header | fwpmu.h |
| Библиотека | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |