PFN_FWADDDYNAMICKEYWORDADDRESS0 netfw.h (回呼函式)
您呼叫以新增指定動態關鍵字位址之服務中進入點的函式指標類型。
注意
此免費函式的指標類型是透過 NetFw.h 發佈，但不會發佈靜態程式庫。 使用LoadLibraryExW/GetProcAddress模式來呼叫此函式。
當您呼叫 GetProcAddress時，將控制碼傳遞至 firewallapi.dll 模組，並將 FWAddDynamicKeywordAddress0 當做 lpProcName 引數傳遞。
如需詳細資訊和程式碼範例，請參閱 防火牆動態關鍵字。
語法
PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;
DWORD PfnFwadddynamickeywordaddress0(
const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}
參數
dynamicKeywordAddress
類型：const PFW_DYNAMIC_KEYWORD_ADDRESS0
已填入動態關鍵字位址物件) 常數 (指標。
傳回值
類型： DWORD
如果函式成功 (成功建立物件並新增) ，則會 傳回ERROR_SUCCESS。 否則，它會傳回下列其中一個值。
| 傳回值 | 描述 |
|---|---|
| ERROR_ACCESS_DENIED | 呼叫端沒有適當的許可權可建立此物件。 |
| ERROR_ALREADY_EXISTS | 系統上已有具有指定識別碼的物件。 |
| ERROR_INVALID_PARAMETER | 無效 的FW_DYNAMIC_KEYWORD_ADDRESS0。 See Remarks for valid usage. |
備註
- 如果 已設定FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 旗標，則：
- 位址必須是 Null，而且
- 關鍵字欄位應該是可解析的字串;也就是 FQDN 或主機名稱。
- 如果未設定FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE旗標，位址欄位必須是以逗號分隔的 IP 位址權杖清單。 權杖可以是個別 IP 位址、範圍或子網。 有效的權杖格式包括：
- 有效的 IPv4 位址 (，例如 10.0.0.10)
- 有效的 IPv6 位址 (，例如 2620：1ec：c11：：200)
- 格式 < 為起始位址 >< 端位址 > 的 IPv4 位址範圍，不含空格 (例如 10.0.0.0-10.0.0.0.255)
- 開頭位址 >< 端位址 > 格式 < 的 IPv6 位址範圍，不含空格 (例如 2001：db8：abcd：12：：-2001：db8：abcd：12：ffff：ffff：ffff)
- 使用網路首碼標記法指定的有效 IPv4 子網 (，例如 10.0.0.0/24)
- 使用前置長度標記法 (指定的有效 IPv6 子網，例如 2001：db8：abcd：0012：：0/64)
- 動態關鍵字位址會在重新開機時保存。 針對 AutoResolved 物件，位址 不會 跨開機週期保存，而且必須在下列開機週期期間重新評估。
需求
| 最低支援的用戶端 | Windows 10組建 20348 |
| 最低支援的伺服器 | Windows 10組建 20348 |
| 目標平台 | Windows |
| 標頭 | netfw.h |
| Dll | firewallapi.dll |