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

Статья
02/07/2025

Функция FwpsAleEndpointCreateEnumHandle0 создает дескриптор, который можно использовать с другими функциями конечных точек уровня приложений (ALE) для перечисления данных конечной точки.

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

Синтаксис

NTSTATUS FwpsAleEndpointCreateEnumHandle0(
  [in]           HANDLE                                 engineHandle,
  [in, optional] const FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                                 *enumHandle
);

Параметры

[in] engineHandle

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

[in, optional] enumTemplate

Указатель на объект FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 структура, содержащая параметры, чтобы сузить результаты перечисления конечных точек.

[out] enumHandle

Созданный дескриптор перечисления.

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

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

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

Замечания

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

Требования

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

См. также

FwpsAleEndpointDeskEnumHandle0

FwpsAleEndpointEnum0

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