Share via

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 来获取与句柄的枚举参数匹配的终结点的相关信息。

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

要求

要求 值
最低受支持的客户端 从 Windows 7 开始可用。
目标平台 通用
标头 fwpsk.h (包括 Fwpsk.h)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

另请参阅

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0