(netfw.h) PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 回呼函式
您呼叫以使用輸入識別碼更新動態關鍵字位址之服務中進入點的函式指標類型。
注意
此免費函式的指標類型是透過 NetFw.h發佈，但不會發佈靜態連結庫。 使用 LoadLibraryExW/GetProcAddress 模式來呼叫此函式。
當您呼叫 GetProcAddress 時，將句柄傳遞至 firewallapi.dll 模組，並將 FWFreeDynamicKeywordAddressData0 當作 lpProcName 自變數傳遞。
如需詳細資訊和程式代碼範例，請參閱 防火牆動態關鍵詞。
語法
PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;
DWORD PfnFwupdatedynamickeywordaddress0(
GUID dynamicKeywordAddressId,
PCWSTR updatedAddresses,
BOOL append
)
{...}
參數
dynamicKeywordAddressId
類型： GUID
要更新之動態關鍵詞位址物件的標識碼。
updatedAddresses
類型： PCWSTR
要用來更新物件的IP位址、子網或範圍的逗號分隔清單。
append
類型： BOOL
設定為 TRUE， 且 updatedAddresses 會附加至物件的目前地址清單。 設定為 FALSE，updatedAddresses 將會取代物件的目前位址清單。
傳回值
類型： DWORD
如果函式成功 (物件) 成功更新，則會傳回 ERROR_SUCCESS。 否則，它會傳回下列其中一個值。
| 傳回值 | 描述 |
|---|---|
| ERROR_ACCESS_DENIED | 呼叫端沒有適當的許可權，無法對具有指定標識符的物件操作。 在 MDM 所管理 的非 AutoResolve 物件上呼叫此 API 時，就會發生此錯誤。 |
| ERROR_INVALID_PARAMETER | 常見的錯誤狀況包括：沒有具有指定標識符的物件存在;位址的格式無效。 |
備註
如果 append 為 TRUE，則輸入位址會附加至物件的目前地址清單。 如果輸入參數是已在 物件中設定的位址複本，則會捨棄該位址，並傳回 ERROR_SUCCESS 。
如果位址與動態關鍵詞位址的現有位址欄位中的值完全相同，防火牆服務會將位址視為重複位址。 重複的值會以個別元素為基礎來考慮，因此IP位址清單的更新可能只有捨棄重複輸入的子集。 例如，如果動態關鍵詞位址物件包含 127.0.0.0-127.0.0.255，則會捨棄 或 127.0.0.0/24 的任何輸入127.0.0.0-127.0.0.255。 不過，這類的輸入 127.0.0.0-127.0.0.40 不會被捨棄，因為這是子集，而不是直接重複專案。
如果 append 為 FALSE，則輸入將會覆寫物件的目前地址清單。
源自 MDM 的非 AutoResolve 物件會導致ERROR_ACCESS_DENIED。
透過 API 或 PowerShell) 在本機建立的非 AutoResolve 物件會透過此 API 更新 (。
任何來源的 AutoResolve 物件都可透過此 API 進行更新。
若要清除物件的位址，請針對 updatedAddresses 值傳入 NULL。
updatedAddresses 參數的有效格式是以逗號分隔的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)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 組建 20348 |
| 最低支援的伺服器 | Windows 10 組建 20348 |
| 目標平台 | Windows |
| 標頭 | netfw.h |
| Dll | firewallapi.dll |