MultinetGetConnectionPerformanceA 函式（winnetwk.h）

MultinetGetConnectionPerformance 函式會傳回用來存取網路資源之連線預期效能的相關資訊。

語法

DWORD MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

參數

[in] lpNetResource

指定網路資源之 NETRESOURCE 結構的指標。以下成員在此上下文中具有特定的含義。

成員	Meaning
lp本地名稱	指定本機裝置的緩衝區指標，例如 “F：” 或 “LPT1”，會重新導向至要查詢的網路資源。如果此成員是 Null 或空字串，則會在 lpRemoteName 成員中指定網路資源。如果此旗標指定本機裝置，則會忽略 lpRemoteName 。
lpRemoteName	要查詢之網路資源的指標。資源目前必須具有已建立的連線。例如，如果資源是檔案伺服器上的檔案，則開啟檔案可確保連線。
lp提供者	通常設定為 NULL，但如果資源所在的網路已知，則可以是資源擁有者（提供者）的指標。如果 lpProvider 成員不是 Null，系統會嘗試只傳回具名網路的相關資訊。

[out] lpNetConnectInfoStruct

接收資料之 NETCONNECTINFOSTRUCT 結構的指標。

傳回值

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

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

傳回碼	Description
ERROR_NOT_SUPPORTED	網路資源不會提供此資訊。
ERROR_NOT_CONNECTED	lpNetResource 參數所指向之 NETRESOURCE 結構的 lpLocalName 成員未指定重新導向的裝置，或 lpRemoteName 成員未指定目前連線之資源名稱。
ERROR_NO_NET_OR_BAD_PATH	無法完成作業，因為網路元件未啟動，或因為無法辨識指定的資源名稱。
ERROR_BAD_DEVICE	lpLocalName 成員所指定的本機裝置無效。
ERROR_BAD_NET_NAME	找不到網路名稱。如果 lpNetResource 參數所指向之 NETRESOURCE 結構的 lpLocalName 成員為 Null，且 lpNetResource 所指向之 NETRESOURCE 結構的 lpRemoteName 成員也為 Null 或 Null 或任何網路無法辨識，則會傳回此錯誤。
ERROR_INVALID_ADDRESS	嘗試存取無效的位址。如果 lpNetResource 或 lpNetConnectInfoStruct 參數為 Null，則會傳回此錯誤。
ERROR_INVALID_PARAMETER	傳遞了一個錯誤的參數。如果 lpNetConnectInfoStruct 參數未指向 cbStructure 成員填入適當結構大小的 NETCONNECTINFOSTRUCT 結構，則會傳回此錯誤。
ERROR_NO_NETWORK	網路無法使用。
ERROR_EXTENDED_ERROR	發生網路特定的錯誤。若要取得錯誤的描述，請呼叫 WNetGetLastError。

備註

MultinetGetConnectionPerformance 函式會傳回 NETCONNECTINFOSTRUCT 結構中的資訊。

MultinetGetConnectionPerformance 函式所傳回的資訊只是估計值。網路流量和路由可能會影響傳回結果的準確性。

請注意， MultinetGetConnectionPerformance 函式只能用來要求重新導向至網路資源之本機裝置的資訊，或目前有連線的網路資源的資訊。

如果在 lpNetResource 參數所指向之 NETRESOURCE 結構的 lpRemoteName 成員中指定 UNC 路徑，則 lpRemoteName 成員必須是目錄名稱，而不是檔名。

使用此函式的一般方式是在網路伺服器上開啟檔案（，以確保有與檔案的連線），呼叫此函式，並使用結果來決定如何管理檔案 I/O。例如，您可以決定是將整個檔案讀取到用戶端上的暫存檔案中，還是直接存取伺服器上的檔案。

備註

winnetwk.h 標頭會將 MultinetGetConnectionPerformance 定義為別名，可根據 UNICODE 前置處理器常數的定義自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

需求

Requirement	價值觀
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
Header	winnetwk.h
Library	Mpr.lib
DLL檔案	Mpr.dll