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 枚举会话时从系统检索的信息。

客户端不提供 成员 processIdsidusernamekernelMode 。 它们由 BFE 提供,可在枚举会话时检索。

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

要求

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

另请参阅

FWPM_DISPLAY_DATA0

FwpmEngineOpen0

FwpmSessionEnum0

Windows 筛选平台 API 结构