FwpsvSwitchEventsSubscribe0 函式 (fwpsk.h)

FwpsvSwitchEventsSubscribe0 函式會註冊虛擬交換器層事件的回呼進入點，例如虛擬埠建立和刪除。

注意FwpsvSwitchEventsSubscribe0 是特定版本的 FwpsvSwitchEventsSubscribe。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。

 

語法

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

參數

providerGuid

提供者 GUID。

notifyContext

圖說文字驅動程式提供內容的選擇性指標。 事件通知函式會將此參數傳回驅動程式。

flags

保留的。 設定為零。

reserved

保留的。 設定為零。

eventDispatchTable

定義虛擬交換器層事件的回呼進入點 之FWPS_VSWITCH_EVENT_DISPATCH_TABLE 結構的指標。

subscriptionId

變數的指標，其中包含一個可指派給訂用帳戶的唯一標識符。 呼叫端必須使用 FwpsvSwitchEventsUnsubscribe0 函式，將訂用帳戶標識碼傳回至一個與一起的一個方案。

傳回值

FwpsvSwitchEventsSubscribe0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	Description
STATUS_SUCCESS	已成功傳回分類要求的句柄。 classifyHandle 參數指向的變數，包含分類要求的句柄。
其他狀態代碼	發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpsvSwitchEventsSubscribe0 函式，以註冊虛擬交換器層事件的回呼進入點。

回呼通知函式的進入點是在 和 FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 結構中指定。

圖說文字驅動程式稍後必須呼叫 FwpsvSwitchEventsUnsubscribe0 以釋放系統資源。

規格需求

需求	值
最低支援的用戶端	從 Windows 8 開始提供。
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

另請參閱

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0