getIfEntry2Ex 函式 (netioapi.h)

GetIfEntry2Ex 函式會擷取本機計算機上所指定介面的指定資訊層級。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfEntry2Ex(
  [in]      MIB_IF_ENTRY_LEVEL Level,
  [in, out] PMIB_IF_ROW2       Row
);

[in] Level

要擷取的介面資訊層級。此參數可以是 Netioapi.h 頭檔中所定義MIB_IF_ENTRY_LEVEL列舉類型的其中一個值。

值	意義
MibIfEntryNormal 0	Row 參數所指向之MIB_IF_ROW2結構成員中傳回的統計數據和狀態值，會從篩選堆棧頂端傳回。
MibIfEntryNormalWithoutStatistics 2	在 Row 參數所指向之MIB_IF_ROW2結構的成員中傳回狀態 (值，而沒有統計數據) 會從篩選堆棧頂端傳回。

[in, out] Row

在成功傳回時， MIB_IF_ROW2 結構的指標會接收本機計算機上介面的資訊。在輸入時，MIB_IF_ROW2的 InterfaceLuid 或 InterfaceIndex 成員必須設定為要擷取資訊的介面。

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

傳回碼	Description
ERROR_FILE_NOT_FOUND	系統找不到指定的檔案。如果 Row 參數所指向 MIB_IF_ROW2之interfaceLuid 或 InterfaceIndex 成員所指定的網路介面 LUID 或介面索引不是本機電腦上的值，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	無效的參數已傳遞至函式。如果在 Row 參數中傳遞 NULL 參數，就會傳回此錯誤。如果未指定 Row 參數所指向之MIB_IF_ROW2的 InterfaceLuid 和 InterfaceIndex 成員，也會傳回此錯誤。
其他	使用 FormatMessage 函式來取得傳回錯誤的訊息字串。

The
GetIfEntry2Ex 函 式會擷取本機系統上指定介面的資訊，並在指向的指標中傳回這項資訊
MIB_IF_ROW2 結構。 GetIfEntry2Ex 是 GetIfEntry2 函式的增強版本，可讓您選取要擷取的介面資訊層級。

在輸入時，必須初始化在 Row 參數中傳遞MIB_IF_ROW2結構中至少一個下列成員：InterfaceLuid 或 InterfaceIndex。

欄位會依照上面所列的順序使用。因此，如果指定 InterfaceLuid ，則會使用此成員來判斷介面。如果未為 InterfaceLuid 成員設定任何值， (這個成員的值設定為零) ，則接著會使用 InterfaceIndex 成員來判斷介面。

輸出時，會填入 Row 參數所指向之MIB_IF_ROW2結構的其餘欄位。

請注意， Netioapi.h 頭檔會自動包含在 Iphlpapi.h 頭檔中，而且絕對不應該直接使用。