FwpmEngineOpen0 函数 (fwpmk.h)

项目
02/26/2024

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

注意

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

语法

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 参数指向的变量包含打开会话的句柄。
其他状态代码	出现了错误。

注解

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

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

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

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

要求

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