通过

FwpmEngineOpen0 函数 （fwpmk.h）

  • 项目

FwpmEngineOpen0 函数将打开筛选器引擎的会话。

语法

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

参数

[in, optional] serverName

指向以 NULL 结尾的字符串的指针，该字符串指定打开到筛选器引擎的会话的系统的标准 DNS 名称。 标注驱动程序必须为此参数指定 NULL。

[in] authnService

要使用的身份验证服务。 有关此参数的有效选项列表，请参阅 Microsoft Windows SDK 文档中 RPC 部分中的 Authentication-Service 常量。 标注驱动程序必须为此参数指定RPC_C_AUTHN_WINNT或RPC_C_AUTHN_DEFAULT。

[in, optional] authIdentity

指向 SEC_WINNT_AUTH_IDENTITY_W 结构的指针，该结构包含用于访问筛选器引擎的身份验证和授权凭据。 从标注驱动程序调用 FwpmEngineOpen0 函数时，将忽略此参数。 标注驱动程序应将此参数设置为 NULL。

[in, optional] session

指向 FWPM_SESSION0 结构的指针，该结构定义要打开的会话的特定于会话的参数。 此指针是可选的，可以 NULL。

[out] engineHandle

指向接收打开会话到筛选器引擎的句柄的变量的指针。

返回值

FwpmEngineOpen0 函数返回以下 NTSTATUS 代码之一。

返回代码 描述
STATUS_SUCCESS 已成功打开筛选引擎的会话。 engineHandle 参数指向的变量包含打开会话的句柄。
其他 NTSTATUS 代码 发生错误。

言论

标注驱动程序调用 FwpmEngineOpen0 函数以打开对筛选器引擎的会话。 对筛选器引擎打开会话的句柄是大多数 Windows 筛选平台管理功能的必需参数。

标注驱动程序通常不需要打开筛选器引擎的会话，因为标注驱动程序通常不调用任何 Windows 筛选平台 管理功能。

要使标注驱动程序成功打开与筛选器引擎的会话，筛选器引擎当前必须在标注驱动程序调用 FwpmEngineOpen0 函数时运行。 标注驱动程序可以调用 FwpmBfeStateGet0 函数以获取筛选器引擎的当前状态。 在调用 FwpmBfeStateGet0之前，标注驱动程序必须调用 FwpmBfeStateSubscribeChanges0 函数，以注册每当筛选器引擎状态发生更改时将调用的回调函数。

标注驱动程序访问筛选器引擎后，它会调用 FwpmEngineClose0 函数以关闭与筛选器引擎的打开会话。

FwpmEngineOpen0 是 FwpmEngineOpen的特定版本。 有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。

要求

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

另请参阅