FWPM_SESSION0 结构 (fwpmtypes.h)

  • 项目

FWPM_SESSION0结构存储与客户端会话关联的状态。

语法

typedef struct FWPM_SESSION0_ {
  GUID               sessionKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  UINT32             txnWaitTimeoutInMSec;
  DWORD              processId;
  SID                *sid;
  wchar_t            *username;
  BOOL               kernelMode;
} FWPM_SESSION0;

成员

sessionKey

唯一标识会话。

如果在调用 FwpmEngineOpen0 时此成员为零，则基本筛选引擎 (BFE) 将生成 GUID。

displayData

允许以人类可读的形式批注会话。

有关详细信息 ，请参阅FWPM_DISPLAY_DATA0 。

flags

用于控制会话行为的设置。

会话标志 含义
FWPM_SESSION_FLAG_DYNAMIC
 设置此标志后，会话结束时，将自动删除在会话期间添加的任何对象。
FWPM_SESSION_FLAG_RESERVED
 保留。

txnWaitTimeoutInMSec

客户端等待开始事务的时间（以毫秒为单位）。

如果此成员为零，BFE 将使用默认超时。

processId

客户端的进程 ID。

sid

客户端的 SID。

username

客户端的用户名。

kernelMode

如果这是内核模式客户端，则为 TRUE。

注解

此结构包含客户端在通过调用 FwpmEngineOpen0 创建会话时提供的信息，或通过调用 FwpmSessionEnum0 枚举会话时从系统检索的信息。

客户端不提供 成员 processId、 sid、 username 和 kernelMode 。 它们由 BFE 提供，可在枚举会话时检索。

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

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 fwpmtypes.h

另请参阅

FWPM_DISPLAY_DATA0

FwpmEngineOpen0

FwpmSessionEnum0

Windows 筛选平台 API 结构