Функция FwpsAleEndpointEnum0 (fwpsk.h)

Статья
02/07/2025

Функция FwpsAleEndpointEnum0 перечисляет конечные точки применения уровня приложений (ALE).

ПримечаниеFwpsAleEndpointEnum0 — это определенная версия FwpsAleEndpointEnum. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Синтаксис

NTSTATUS FwpsAleEndpointEnum0(
  [in]  HANDLE                        engineHandle,
  [in]  HANDLE                        enumHandle,
  [in]  UINT32                        numEntriesRequested,
  [out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
  [out] UINT32                        *numEntriesReturned
);

Параметры

[in] engineHandle

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

[in] enumHandle

Дескриптор перечисления, созданный предыдущим вызовом FwpsAleEndpointDebienumHandle0.

[in] numEntriesRequested

Максимальное количество возвращаемых записей свойств конечной точки. Фактическое число перечисленных записей возвращается в numEntriesReturned. Фактическое число меньше запрошенного числа, только если меньше конечных точек, чем запрошено.

[out] entries

Указатель на массив указателей FWPS_ALE_ENDPOINT_PROPERTIES0 структуры. Каждая структура содержит свойства одной конечной точки. Массив содержит столько элементов, сколько значение, возвращаемое в numEntriesReturned.

[out] numEntriesReturned

При возврате число элементов в массиве структур свойств конечной точки, на которые указывают записи.

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

Функция FwpsAleEndpointEnum0 возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Функция завершилась успешно.
Другие коды состояния	Произошла ошибка.

Замечания

Чтобы перечислить конечные точки ALE, драйвер выноски должен сначала получить дескриптор перечисления, вызвав FwpsAleEndpointCreateEnumHandle0. Возвращенный дескриптор связан с любыми параметрами, указанными в необязательном параметре enumTemplateFwpsAleEndpointCreateEnumHandle0.

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

Обратите внимание, что поле localV4Address из возвращаемого FWPS_ALE_ENDPOINT_PROPERTIES0 находится в порядке байтов узла, а localV6Address находится в порядке байтов сети. Чтобы использовать IPv4-адрес из поля localV4Address, необходимо вызвать htonl() в localV4Address, чтобы сохранить его в структуре in_addr и убедиться, что sockaddr правильно отформатирован.

После завершения проверки свойств конечной точки драйвер выноски должен вызывать FwpsAleEndpointDebuildEnumHandle0, чтобы освободить системные ресурсы, связанные с дескриптором перечисления.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
библиотеки	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

См. также

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDecreaumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0

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