共用方式為

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

用戶端的進程識別碼。

sid

用戶端的 SID。

username

用戶端的用戶名稱。

kernelMode

如果這是核心模式用戶端，則為TRUE。

備註

此結構包含客戶端藉由呼叫 FwpmEngineOpen0 建立會話時所提供的資訊，或藉由呼叫 FwpmSessionEnum0 列舉會話時從系統擷取的資訊。

用戶端不會提供成員 processId、 sid、 username 和 kernelMode 。 BFE 會提供它們，而且可以在列舉會話時加以擷取。

FWPM_SESSION0 是FWPM_SESSION的特定實作。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 fwpmtypes.h

另請參閱

FWPM_DISPLAY_DATA0

FwpmEngineOpen0

FwpmSessionEnum0

Windows 篩選平臺 API 結構