共用方式為

fwpmNetEventSubscribe3 函式 (fwpmu.h)

  • 發行項

用來要求有關特定 Net 事件的通知傳遞。

語法

DWORD FwpmNetEventSubscribe3(
  HANDLE                             engineHandle,
  const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  FWPM_NET_EVENT_CALLBACK3           callback,
  void                               *context,
  HANDLE                             *eventsHandle
);

參數

engineHandle

類型：_In_ HANDLE

使用篩選引擎開啟會話的句柄。 若要使用篩選引擎開啟會話，請呼叫 FwpmEngineOpen0。

subscription

描述將傳遞哪些通知 的FWPM_NET_EVENT_SUBSCRIPTION0 結構。

callback

類型為 FWPM_NET_EVENT_CALLBACK3 的函式指標，當通知準備好傳遞時，將會叫用此函式。

context

選擇性的內容指標。 此指標會連同事件的詳細數據一起傳遞至 回調 函式。

eventsHandle

新建立訂閱的句柄。 當不再需要訂閱時，呼叫 FwpmNetEventUnsubscribe0 以關閉此句柄。

傳回值

傳回碼/值 Description
ERROR_SUCCESS
0		 已成功建立訂用帳戶。
FWP_E_* 錯誤碼
0x80320001— 0x80320039		 Windows 篩選平臺 () 特定錯誤。 如需詳細數據，請參閱 一文中的一個錯誤碼。
RPC_* 錯誤碼
0x80010001— 0x80010122		 無法與遠端或本機防火牆引擎通訊。

備註

您無法在交易內呼叫此函式。 它將會失敗 ，並FWP_E_TXN_IN_PROGRESS。 如需交易的詳細資訊，請參閱 物件管理。

若要呼叫此函式，您需要 FWPM_ACTRL_SUBSCRIBE net 事件容器的存取權。

規格需求

需求 值
標頭 fwpmu.h
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll