FwpsAleEndpointEnum0 函数 （fwpsk.h）

FwpsAleEndpointEnum0 函数枚举应用程序层强制（ALE）终结点。

注释FwpsAleEndpointEnum0 是 FwpsAleEndpointEnum的特定版本。 有关详细信息，请参阅 WFP 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来获取枚举句柄。 返回的句柄与 FwpsAleEndpointCreateEnumHandle0的可选 enumTemplate 参数中指定的任何参数相关联。

获取句柄后，标注驱动程序可以调用 FwpsAleEndpointEnum0 以获取与句柄枚举参数匹配的终结点的信息。

请注意，返回FWPS_ALE_ENDPOINT_PROPERTIES0的 localV4Address 字段按主机字节顺序排列，而 localV6Address 则按网络字节顺序排列。 若要使用 localV4Address 字段中的 IPv4 地址，必须在 localV4Address 上调用 htonl（），以将其存储在in_addr结构中，并确保 sockaddr 格式正确。

检查完终结点属性后，标注驱动程序必须调用 FwpsAleEndpointDestroyEnumHandle0 才能释放与枚举句柄关联的系统资源。

要求

要求	价值
最低支持的客户端	从 Windows 7 开始可用。
目标平台	普遍
标头	fwpsk.h （包括 Fwpsk.h）
库	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

另请参阅

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0