multinetGetConnectionPerformanceA 函式 (winnetwk.h)
MultinetGetConnectionPerformance函式會傳回用來存取網路資源之連線預期效能的相關資訊。
語法
DWORD MultinetGetConnectionPerformanceA(
[in] LPNETRESOURCEA lpNetResource,
[out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);
參數
[in] lpNetResource
指定網路資源的 NETRESOURCE 結構的指標。 下列成員在此內容中具有特定意義。
[out] lpNetConnectInfoStruct
接收資料的 NETCONNECTINFOSTRUCT 結構的指標。
傳回值
如果函式成功，傳回值會NO_ERROR。
如果函式失敗，傳回值是 系統錯誤碼，例如下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
網路資源不提供此資訊。 |
|
lpNetResource參數所指向之 NETRESOURCE結構的lpLocalName成員未指定重新導向的裝置，或lpRemoteName成員未指定目前連線的資源名稱。 |
|
無法完成作業，可能是因為網路元件未啟動，或因為無法辨識指定的資源名稱。 |
|
lpLocalName成員指定的本機裝置無效。 |
|
找不到網路名稱。 如果lpNetResource所指向之 NETRESOURCE結構的lpLocalName成員是Null，而且lpNetResource結構所指向之NETRESOURCE結構的lpRemoteName成員也是或Null，或無法由任何網路辨識，就會傳回此錯誤。 |
|
嘗試存取不正確位址。 如果 lpNetResource 或 lpNetConnectInfoStruct 參數為 Null，就會傳回此錯誤。 |
|
傳遞了不正確的參數。 如果lpNetConnectInfoStruct參數未指向CBStructure成員填入適當結構大小的NETCONNECTINFOSTRUCT結構，就會傳回此錯誤。 |
|
網路無法使用。 |
|
發生網路特定的錯誤。 若要取得錯誤的描述，請呼叫 WNetGetLastError。 |
備註
MultinetGetConnectionPerformance函式會傳回NETCONNECTINFOSTRUCT結構中的資訊。
MultinetGetConnectionPerformance函式所傳回的資訊只是估計值。 網路流量和路由可能會影響傳回結果的精確度。
請注意， MultinetGetConnectionPerformance 函式只能用於要求重新導向至網路資源的本機裝置，或目前有連線的網路資源的資訊。
如果在lpNetResource參數所指向之 NETRESOURCE結構的lpRemoteName成員中指定 UNC 路徑，lpRemoteName成員必須是目錄名稱，而不是檔案名。
使用此函式的一般方法是在網路伺服器上開啟檔案 (，以確保檔案有連線) 、呼叫此函式，並使用結果來決定如何管理檔案 I/O。 例如，您可以決定是否要將整個檔案讀取到用戶端上的暫存檔案，或直接存取伺服器上的檔案。
注意
winnetwk.h 標頭會根據 UNICODE 預處理器常數的定義，將 MultinetGetConnectionPerformance 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winnetwk.h |
| 程式庫 | Mpr.lib |
| Dll | Mpr.dll |