文章編號: 193059 - 上次校閱: 2005年7月11日 - 版次: 2.4

資訊: IP Helper API 新增網路組態和 stat 資訊到 Win32 應用程式

中英文對照顯示按一下這裡顯示機器翻譯的中英文對照
機器翻譯檢視機器翻譯免責聲明
檢視此文章適用的產品。
系統提示本文適用於您使用的作業系統之外的作業系統。與您不相關的文章內容已停用。

在此頁中

全部展開 | 全部摺疊

結論

IP 協助程式 API (IPHLPAPI) 是提供 Windows 網路設定與 Windows 32 位元應用程式的統計資料資訊的公用 API。 API 是可用的 Windows NT 4.0 服務套件 4 和以後，和 Windows 98 和 Windows 2000。並非所有的 IP 協助程式 API 有可用的 Windows NT 4.0 和 Windows 98 平台。
回此頁最上方

其他相關資訊

本文提供 IP 協助程式 API 可用的簡要的說明分組它們執行的工作或它們作業的物件。IP 協助程式 API 包括範例程式碼的額外資訊會在 Windows NT 5.0 Beta 2 平台 SDK 版本上使用和更新版本。
回此頁最上方

介面類別

這個類別允許應用程式來擷取網路介面卡特性資訊。IP 協助程式 API 可供 Windows NT 4.0 Service Pack 4 如下所示：
  • GetIfTable: 抓取所有網路介面卡實體特性。
  • GetIfEntry: 擷取特定的介面卡特性。
  • SetIfEntry： 更新特定配接器的作業狀態，例如描述介面向上、 向下，或測試模式中。
  • SetIpTTL: 允許修改 (TTL) 欄位 [時間] 從您的系統傳送的所有 IP 封包的應用程式。
回此頁最上方

IP 位址類別

這個類別可讓應用程式修改，並擷取 IP 組態資訊。不過，Windows NT 4.0 Service Pack 4 上不支援大部分的這些 API。IP 協助程式 API 可供 Windows NT 4.0 SP 4 如下所示：
  • GetIpAddrTable： 可讓應用程式擷取 IP 位址資訊。
回此頁最上方

ARP 資料表類別

這個類別會提供存取給位址解析通訊協定 (ARP) 的項目對應從實體位址的 IP 位址。IP 協助程式 API 可供 Windows NT 4.0 服務套件 4 如下所示：
  • GetIpNetTable: 擷取位址解析表格資訊。
  • SetIpNetEntry： 將項目新增至 ARP 資料表。
  • DeleteIpNetEntry： 從 ARP 資料表刪除項目。
回此頁最上方

路由表類別

這個類別允許擷取 IP 路由資訊的應用程式，並允許修改路由項目在資料表中的應用程式。 路由是下個躍點位址從哪些傳送封包的路由表的選取範圍。IP 協助程式 API 可供 Windows NT 4.0 下面列出服務套件 4：
  • GetIpForwardTable: 抓取路由表格資訊。
  • SetIpForwardEntry： 新增路由表項目。
  • DeleteIpForwardEntry： 刪除路由表項目。
  • GetRTTAndHopCount： 提供近似往返至特定的 IP 目的地的時間資訊，而且也提供該目的地的躍點計數。
回此頁最上方

統計資料類別

這個類別提供有關本機電腦上的封包/連線統計資料資訊的各種資訊。IP 協助程式 API 可使用的 Windows NT 4.0 服務套件 4 如下：
  • GetIpStatistics: 擷取網際網路通訊協定 (IP) 封包的統計資料。
  • GetIcmpStatistics: 擷取網際網路控制訊息通訊協定 (ICMP) 統計資料。
  • GetTcpStatistics: 擷取傳輸控制通訊協定 (TCP) 統計資料。
  • GetUdpStatistics: 擷取使用者資料包通訊協定 (UDP) 統計資料。
回此頁最上方

IP Helper API 慣例

介面被解決的是大型的 DWORD 數字的索引。預期易記介面數字，例如 MIB (UI) 的應用程式使用 GetFriendlyIndex() 單向轉換成易記的索引。

傳回結構的陣列的函式會採用在/out 大小參數 pSize。使用者會初始化 pSize，讓它指向傳遞至函式緩衝區的大小。在成功呼叫這個參數會保留傳回資料的實際的大小。如果函式失敗，因為緩衝區太小，保存所有可用的資料所需的緩衝區大小的 pSize 指向並函式傳回 Win32 錯誤狀態。大部份的這些 IP 協助程式 API 傳回 ERROR_INSUFFICIENT_BUFFER ； 例外狀況是 GetNetworkParams() 和 GetAdaptersInfo() API 傳回 ERROR_BUFFER_OVERFLOW。
回此頁最上方
這篇文章中的資訊適用於:
  • Microsoft Platform Software Development Kit-January 2000 Edition?應用於:
    • Microsoft Windows NT 4.0
    • Microsoft Windows 98 Standard Edition
    • the operating system: Microsoft Windows 2000
回此頁最上方
關鍵字：?
kbmt kbapi kbfea kbinfo kbiphelp kbnetwork KB193059 KbMtzh
回此頁最上方
機器翻譯機器翻譯
重要：本文是以 Microsoft 機器翻譯軟體翻譯而成，而非使用人工翻譯而成。Microsoft 同時提供使用者人工翻譯及機器翻譯兩個版本的文章，讓使用者可以依其使用語言使用知識庫中的所有文章。但是，機器翻譯的文章可能不盡完美。這些文章中也可能出現拼字、語意或文法上的錯誤，就像外國人在使用本國語言時可能發生的錯誤。Microsoft 不為內容的翻譯錯誤或客戶對該內容的使用所產生的任何錯誤或損害負責。Microsoft也同時將不斷地就機器翻譯軟體進行更新。
按一下這裡查看此文章的英文版本：193059? (http://support.microsoft.com/kb/193059/en-us/ )
回此頁最上方
Microsoft及(或)其供應商不就任何在本伺服器上發表的文字資料及其相關圖表資訊的恰當性作任何承諾。所有文字資料及其相關圖表均以「現狀」供應，不負任何擔保責任。Microsoft及(或)其供應商謹此聲明，不負任何對與此資訊有關之擔保責任，包括關於適售性、適用於某一特定用途、權利或不侵權的明示或默示擔保責任。Microsoft及(或)其供應商無論如何不對因或與使用本伺服器上資訊或與資訊的實行有關而引起的契約、過失或其他侵權行為之訴訟中的特別的、間接的、衍生性的損害或任何因使用而喪失所導致的之損害、資料或利潤負任何責任。