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

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

  • Статья

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

Примечание

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

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

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

Синтаксис

PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;

DWORD PfnFwupdatedynamickeywordaddress0(
  GUID dynamicKeywordAddressId,
  PCWSTR updatedAddresses,
  BOOL append
)
{...}

Параметры

dynamicKeywordAddressId

Тип: GUID

Идентификатор обновляемого динамического объекта ключевое слово адреса.

updatedAddresses

Тип: PCWSTR

Разделенный запятыми список IP-адресов, подсетей или диапазонов для обновления объекта.

append

Тип: BOOL

Задайте значение TRUE, а объект updatedAddresses будет добавлен в текущий список адресов объекта. Установите значение FALSE, а параметр updatedAddresses заменит текущий список адресов объекта.

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

Тип: DWORD

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

Возвращаемое значение Описание
ERROR_ACCESS_DENIED Вызывающий объект не имеет соответствующих разрешений для работы с объектом с указанным идентификатором. Эта ошибка возникает при вызове этого API для объектов, не относящихся к AutoResolve , управляемых MDM.
ERROR_INVALID_PARAMETER Распространенные условия ошибки: объект с указанным идентификатором не существует; адреса имеют недопустимый формат.

Комментарии

Если параметр append имеет значение TRUE, входные адреса будут добавлены в текущий список адресов объекта. Если входной параметр является дубликатом адреса, уже заданного в объекте , он будет удален и ERROR_SUCCESS будет возвращен.

Служба брандмауэра обрабатывает адрес как дубликат, если адрес точно эквивалентен значению в поле существующих адресов динамического ключевое слово адреса. Повторяющиеся значения считаются отдельными элементами, поэтому обновление со списком IP-адресов может иметь только подмножество повторяющихся входных данных. Например, если динамический объект адреса ключевое слово содержит 127.0.0.0-127.0.0.255, то любые входные данные 127.0.0.0-127.0.0.255 или 127.0.0.0/24 будут удалены. Однако входные данные, такие как 127.0.0.0-127.0.0.40 , не будут удалены, так как это подмножество, а не прямой дубликат.

Если параметр append имеет значение FALSE, текущий список адресов объекта будет перезаписан входными данными.

Объекты, не относящиеся к autoResolve, полученные из MDM, приведут к ERROR_ACCESS_DENIED.

Объекты, не относящиеся к autoResolve, которые были созданы локально (с помощью API или PowerShell), обновляются с помощью этого API.

Объекты autoResolve любого источника можно обновлять с помощью этого API.

Чтобы очистить адреса объекта, передайте значение NULL для значения updatedAddresses .

Допустимый формат для параметра updatedAddresses — это разделенный запятыми список маркеров 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).

Требования

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

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