GetIcmpStatisticsEx 函式 (iphlpapi.h)
GetIcmpStatisticsEx 函式會擷取本機計算機的因特網控制訊息通訊協定 (ICMP) 統計數據。 GetIcmpStatisticsEx 函式能夠擷取 IPv6 ICMP 統計數據。
語法
IPHLPAPI_DLL_LINKAGE ULONG GetIcmpStatisticsEx(
[out] PMIB_ICMP_EX Statistics,
[in] ULONG Family
);
參數
[out] Statistics
包含本機計算機的ICMP統計數據 之MIB_ICMP_EX 結構的指標。
[in] Family
要為其擷取ICMP統計數據的通訊協定系列。 必須是下列其中之一：
| 值 | 意義 |
|---|---|
|
因特網通訊協定第 4 版 (IPv4) 。 |
|
網際網路通訊協定第 6 版 (IPv6)。 |
傳回值
如果函式成功，傳回值會NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 傳回碼 | Description |
|---|---|
|
pStats 參數為 NULL 或未指向有效的記憶體，或 dwFamily 參數不是有效的值。 |
|
在進行函式呼叫的作業系統上不支援此函式。 |
|
使用 FormatMessage 取得傳回錯誤的訊息字串。 |
備註
GetIpStatisticsEx 可用來取得本機電腦上 IPv4 或 IPv6 的 ICMP 統計數據。
GetIcmpStatistics 函式只會針對本機電腦上的 IPv4 傳回 ICMP 統計數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | iphlpapi.h |
| 程式庫 | Iphlpapi.lib |
| Dll | Iphlpapi.dll |