创建可与其他应用程序层强制(ALE)终结点函数一起使用的句柄来枚举终结点数据。
注释
FwpsAleEndpointCreateEnumHandle0 是 FwpsAleEndpointCreateEnumHandle 的特定版本。 有关详细信息,请参阅 WFP 与版本无关的名称和面向特定版本的 Windows。
Syntax
DWORD FwpsAleEndpointCreateEnumHandle0(
HANDLE engineHandle,
const FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 *enumTemplate,
HANDLE *enumHandle
);
参数
engineHandle
使用筛选器引擎打开的会话句柄。 通过调用 FwpmEngineOpen0 打开会话时,将获取此句柄。
enumTemplate
指向 FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 结构的指针,该结构包含用于缩小终结点枚举结果范围的参数。
enumHandle
新建的枚举句柄。
返回值
FwpsAleEndpointCreateEnumHandle0 函数返回以下 NTSTATUS 代码之一。
| 返回代码 | Description |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| 其他状态代码 | 出现了错误。 |
注解
使用通过调用 FwpsAleEndpointCreateEnumHandle0 获取的句柄后,标注驱动程序必须通过调用 FwpsAleEndpointDestroyEnumHandle0 释放与句柄关联的系统资源。
要求
| Requirement | 价值 |
|---|---|
| Header | fwpsu.h |
| Library | fwpuclnt.lib |