GetIfEntry2 函式
GetIfEntry2 函式會擷取本機計算機上指定介面的資訊。
重要
對於驅動程式開發人員，建議盡可能搭配MibIfEntryNormalWithoutStatistics使用 GetIfEntry2Ex ，以避免維護 NDIS OID 時發生死結。
語法
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
參數
- 列 [in， out]
MIB_IF_ROW2結構的指標，在成功傳回時，會接收本機計算機上介面的資訊。 在輸入時，驅動程式必須將 MIB_IF_ROW2 結構的InterfaceLuid成員或InterfaceIndex成員設定為介面，以擷取資訊。
傳回值
如果函式成功，GetIfEntry2 會傳回STATUS_SUCCESS。
如果函式失敗， GetIfEntry2 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 無效的參數已傳遞至函式。 如果在 Row 參數中傳遞 NULL 指標，則會傳回此錯誤。 |
| STATUS_NOT_FOUND | 找不到指定的介面。 如果函式找不到 Row 參數指向之MIB_IF_ROW2結構的InterfaceLuid 或 InterfaceIndex 成員所指定的網路介面，就會傳回此錯誤。 |
| 其他 | 使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
在輸入時，驅動程式必須在傳入 Row 參數的 MIB_IF_ROW2 結構中，至少初始化 InterfaceLuid 或 InterfaceIndex 成員。 成員會依照稍早所列的順序使用。 因此，如果 指定 InterfaceLuid ，則會使用此成員來判斷介面。 如果 InterfaceLuid 成員未設定任何值（此成員的值設定為零），則接下來會使用 InterfaceIndex 成員來判斷介面。
在輸出中，Row 參數所指向之MIB_IF_ROW2結構的其餘欄位會填入。
需求
目標平台 |
萬用 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
頁首 |
Netioapi.h （包括 Netioapi.h） |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |