Функция FwpsAleEndpointEnum0 (fwpsk.h)
Функция FwpsAleEndpointEnum0 перечисляет конечные точки принудительного применения уровня приложения (ALE).
Синтаксис
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.
Код возврата | Описание |
---|---|
|
Функция выполнена успешно. |
|
Произошла ошибка. |
Комментарии
Чтобы перечислить конечные точки ALE, драйвер выноски должен сначала получить дескриптор перечисления, вызвав FwpsAleEndpointCreateEnumHandle0. Возвращаемый дескриптор связан с любыми параметрами, указанными в необязательном параметре enumTemplateобъекта FwpsAleEndpointCreateEnumHandle0.
После получения дескриптора драйвер выноски может вызвать FwpsAleEndpointEnum0 , чтобы получить сведения о конечных точках, соответствующих параметрам перечисления дескриптора.
По завершении проверки свойств конечной точки драйвер выноски должен вызвать FwpsAleEndpointDefinishedEnumHandle0 , чтобы освободить системные ресурсы, связанные с дескриптором перечисления.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно начиная с Windows 7. |
Целевая платформа | Универсальное |
Верхняя часть | fwpsk.h (включая Fwpsk.h) |
Библиотека | Fwpkclnt.lib |
IRQL | PASSIVE_LEVEL |