共用方式為

GetPerAdapterInfo 函式 (iphlpapi.h)

  • 發行項

GetPerAdapterInfo 函式會擷取對應至指定介面之配接器的相關信息。

語法

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

參數

[in] IfIndex

介面的索引。 GetPerAdapterInfo 函式會擷取對應至此介面之配接器的資訊。

[out] pPerAdapterInfo

接收配接器相關信息 之IP_PER_ADAPTER_INFO 結構的指標。

[in] pOutBufLen

指定IP_PER_ADAPTER_INFO結構大小的ULONG變數指標。 如果此大小不足以保存資訊， GetPerAdapterInfo 會填入此變數中所需的大小，並傳回錯誤碼ERROR_BUFFER_OVERFLOW。

傳回值

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

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

傳回碼 Description
ERROR_BUFFER_OVERFLOW
 pOutBufLen 參數所指示的緩衝區大小太小，無法保存配接器資訊。 pOutBufLen 參數指向所需的大小。
ERROR_INVALID_PARAMETER
 pOutBufLen 參數為 NULL，或者呼叫進程沒有 pOutBufLen 所指向記憶體的讀取/寫入存取權，或者呼叫進程沒有 pAdapterInfo 參數所指向之內存的寫入許可權。
ERROR_NOT_SUPPORTED

本機計算機上執行的操作系統不支援 GetPerAdapterInfo。
其他
 如果函式失敗，請使用 FormatMessage 取得傳回錯誤的訊息字串。
 
 

備註

適配卡索引可能會在適配卡停用后啟用或在其他情況下變更，且不應視為持續性。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 iphlpapi.h
程式庫 Iphlpapi.lib
Dll Iphlpapi.dll

另請參閱

IP 協助程式函式參考

IP 協助程式起始頁

IP_PER_ADAPTER_INFO