共用方式為

multinetGetConnectionPerformanceA 函式 (winnetwk.h)

  • 發行項

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

語法

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

參數

[in] lpNetResource

指定網路資源的 NETRESOURCE 結構的指標。 下列成員在此內容中具有特定意義。

成員 意義
lpLocalName
 指定要查詢之網路資源的緩衝區指標，例如 「F：」 或 「LPT1」。

如果此成員為 Null 或空字串，則會在 lpRemoteName 成員中指定網路資源。 如果此旗標指定本機裝置， 則會忽略 lpRemoteName 。
lpRemoteName
 要查詢的網路資源指標。 資源目前必須有已建立的連接。 例如，如果資源是檔案伺服器上的檔案，則開啟檔案可確保連線。
lpProvider
 通常設定為 Null，但如果已知資源所在的網路，通常是資源 (提供者) 的擁有者指標。

如果 lpProvider 成員不是 Null，系統會嘗試只傳回具名網路的相關資訊。

[out] lpNetConnectInfoStruct

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

傳回值

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

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

傳回碼 描述
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，或無法由任何網路辨識，就會傳回此錯誤。
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 標頭會根據 UNICODE 預處理器常數的定義，將 MultinetGetConnectionPerformance 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winnetwk.h
程式庫 Mpr.lib
Dll Mpr.dll

另請參閱

NETCONNECTINFOSTRUCT

NETRESOURCE

Windows 網路 (WNet) 概觀

Windows 網路功能