функция обратного вызова PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 (netfw.h)
Тип указателя функции точки входа в службе, вызываемой для перечисления динамических ключевое слово адресов по типу. Вы можете запросить определенное подмножество объектов на основе переданных флагов перечисления.
Примечание
Тип указателя для этой бесплатной функции публикуется через NetFw.h, но библиотека статических ссылок не публикуется. Используйте шаблонGetProcAddressLoadLibraryExW/ для вызова этой функции.
При вызове GetProcAddress передайте дескриптор модулю firewallapi.dll и передайте FWEnumDynamicKeywordAddressesByType0 в качестве аргумента lpProcName .
Дополнительные сведения и примеры кода см. в разделе Динамические ключевые слова брандмауэра.
Синтаксис
PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;
DWORD PfnFwenumdynamickeywordaddressesbytype0(
DWORD flags,
PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}
Параметры
flags
Тип: DWORD
При использовании значения FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE будет перечисление всех объектов, для которых установлен флаг FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE .
При использовании значения FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE будет перечисление всех объектов, для которых не задан флаг FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE.
При использовании значения FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE будет перечисление всех объектов.
dynamicKeywordAddressData
Тип: _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*
Адрес указателя на динамический объект ключевое слово address, который будет содержать связанный список возвращаемых объектов. Этот адрес необходимо освободить, вызвав FWFreeDynamicKeywordAddressData0.
Возвращаемое значение
Тип: DWORD
Если функция выполняется успешно, она возвращает ERROR_SUCCESS. В противном случае возвращается одно из следующих значений.
| Возвращаемое значение | Описание |
|---|---|
| ERROR_INVALID_PARAMETER | Для параметра flags было передано нулевое значение. |
Комментарии
Необходимо освободить адрес первого возвращенного объекта в списке (заголовок списка), вызвав FWFreeDynamicKeywordAddressData0.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | сборка Windows 10 20348 |
| Минимальная версия сервера | сборка Windows 10 20348 |
| Целевая платформа | Windows |
| Header | netfw.h |
| DLL | firewallapi.dll |