共用方式為

FwpmDynamicKeywordSubscribe0 函式 (fwpmu.h)

  • 發行項

要求傳送有關特定動態關鍵詞位址變更的通知 ， (FW_DYNAMIC_KEYWORD_ADDRESS0) 物件。 根據傳入的旗標，只能針對位址的子集引發通知。

如需詳細資訊和程式代碼範例，請參閱 防火牆動態關鍵詞。

語法

DWORD FwpmDynamicKeywordSubscribe0(
  DWORD                          flags,
  FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
  void                           *context,
  HANDLE                         *subscriptionHandle
);

參數

flags

類型：_In_ DWORD

下列旗標定義於 中 fwpmu.h。

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE 表示通知只會針對已設定 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 旗標的對象傳遞。

FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE 表示只會針對 未 設定 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 旗標的對象傳遞通知。

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE 表示 所有動態關鍵詞 位址對象都會傳遞通知。

callback

類型：_In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0

您所實作之回呼函式的指標，會在通知準備好傳遞時叫用。

context

類型：_In_opt_ void*

選擇性內容指標。 這個指標會傳遞至回呼函式。

subscriptionHandle

類型：_Out_ HANDLE*

句柄的位址，這個位址會填入新建立之訂閱的句柄。

傳回值

類型： DWORD

如果函式成功，則會傳回 ERROR_SUCCESS。 否則，它會傳回下列其中一個值。

傳回值 描述
ERROR_INVALID_PARAMETER 旗標值為零。

備註

新增或刪除物件時， 會傳遞 AutoResolve 動態關鍵詞位址的通知。

新增、刪除或更新物件時，會傳遞 非 AutoResolve 動態關鍵詞位址的通知。

未提供任何數據給回呼函式。 如果您需要系統上已變更之專案的相關信息，可以使用 列舉 API。

當您不再需要訂用帳戶時，您必須負責關閉句柄。 您必須呼叫 FwpmDynamicKeywordUnsubscribe0 函式來執行此動作。

您的 FWPM_DYNAMIC_KEYWORD_CALLBACK0 實作應該會快速響應動態關鍵字地址物件中的變更，因為它已排程在 ThreadPool 線程上，而且可能會影響其他等候作業。

規格需求

需求 值
最低支援的用戶端 Windows 10 組建 20348
最低支援的伺服器 Windows 10 組建 20348
目標平台 Windows
標頭 fwpmu.h
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll

另請參閱