PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0回呼函式 (netfw.h)

您在服務中呼叫以依類型列舉動態關鍵字地址的進入點函式指標類型。 您可以根據傳入的列舉旗標來要求特定物件的子集。

注意

此免費函式的指標類型是透過 NetFw.h發佈，但不會發佈靜態連結庫。 使用 LoadLibraryExW/GetProcAddress 模式來呼叫此函式。

當您呼叫 GetProcAddress 時，將句柄傳遞至 firewallapi.dll 模組，並傳遞 FWEnumDynamicKeywordAddressesByType0 作為 lpProcName 自變數。

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

語法

PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;

DWORD PfnFwenumdynamickeywordaddressesbytype0(
  DWORD flags,
  PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}

參數

flags

類型： DWORD

使用值 FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE 會列舉已設定 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 旗標的所有物件。

使用值FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE會列舉未設定FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE旗標的擁有物件。

使用值 FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE 會列舉 所有 物件。

dynamicKeywordAddressData

類型：_Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*

動態關鍵字位址物件的指標位址，其會保存傳回之對象的連結清單。 您必須呼叫 FWFreeDynamicKeywordAddressData0 來釋放此位址。

傳回值

類型： DWORD

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

傳回值	描述
ERROR_INVALID_PARAMETER	已針對 flags 參數傳入零值。

備註

您必須呼叫 FWFreeDynamicKeywordAddressData0，以釋放清單中第一個傳回物件的位址， (清單的標頭) 。

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
目標平台	Windows
標頭	netfw.h
Dll	firewallapi.dll

另請參閱

• 防火牆動態關鍵詞