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

  • Статья

Функция 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

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

[in] numEntriesRequested

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

[out] entries

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

[out] numEntriesReturned

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

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

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

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

Комментарии

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

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 7.
Целевая платформа Универсальное
Верхняя часть fwpsk.h (включая Fwpsk.h)
Библиотека Fwpkclnt.lib
IRQL PASSIVE_LEVEL

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

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDecreaEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0