Поделиться через

функция обратного вызова PFN_FWADDDYNAMICKEYWORDADDRESS0 (netfw.h)

  • Статья

Тип указателя функции точки входа в службе, вызываемой для добавления указанного динамического ключевое слово адреса.

Примечание

Тип указателя для этой бесплатной функции публикуется через NetFw.h, но библиотека статических ссылок не публикуется. Используйте шаблонGetProcAddressLoadLibraryExW/ для вызова этой функции.

При вызове GetProcAddress передайте дескриптор в модуль firewallapi.dll и FWAddDynamicKeywordAddress0 в качестве аргумента lpProcName .

Дополнительные сведения и примеры кода см. в разделе Динамические ключевые слова брандмауэра.

Синтаксис

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

DWORD PfnFwadddynamickeywordaddress0(
  const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}

Параметры

dynamicKeywordAddress

Тип: const PFW_DYNAMIC_KEYWORD_ADDRESS0

Указатель на константный (заполненный) динамический ключевое слово объект адреса.

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

Тип: DWORD

Если функция завершается успешно (объект был успешно создан и добавлен), она возвращает ERROR_SUCCESS. В противном случае возвращается одно из следующих значений.

Возвращаемое значение Описание
ERROR_ACCESS_DENIED Вызывающий объект не имеет соответствующих разрешений на создание этого объекта.
ERROR_ALREADY_EXISTS Объект с указанным идентификатором уже существует в системе.
ERROR_INVALID_PARAMETER Недопустимый FW_DYNAMIC_KEYWORD_ADDRESS0. Сведения о допустимом использовании см. в разделе Примечания .

Комментарии

  • Если установлен флаг FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE , выполните следующие действия:
    • адреса должны иметь значение NULL, и
    • Поле ключевое слово должно быть строкой, которую можно разрешить, то есть полным доменным именем или именем узла.
  • Если флаг FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEне задан, поле addresss должно быть разделенным запятыми списком маркеров IP-адресов. Маркеры могут быть отдельными IP-адресами, диапазонами или подсетями. Допустимые форматы маркеров:
    • Допустимый IPv4-адрес (например, 10.0.0.10)
    • Допустимый IPv6-адрес (например, 2620:1ec:c11::200);
    • Диапазон IPv4-адресов< в формате <начального конечного адреса>> без пробелов (например, 10.0.0.0-10.0.0.255).
    • Диапазон адресов IPv6 в формате <начального адреса><> без пробелов (например, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff:ffff: ffff)
    • Допустимая подсеть IPv4, указанная с использованием префикса сети (например, 10.0.0.0/24)
    • Допустимая подсеть IPv6, указанная с использованием нотации длины префикса (например, 2001:db8:abcd:0012::0/64).
  • Динамический адрес ключевое слово сохраняется при перезагрузках. Для объектов AutoResolved адреса не сохраняются в течение циклов загрузки и должны быть повторно оценены во время следующего цикла загрузки.

Требования

   
Минимальная версия клиента Windows 10 сборки 20348
Минимальная версия сервера Windows 10 сборки 20348
Целевая платформа Windows
Header netfw.h
DLL firewallapi.dll

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