npGetConnectionPerformance 函式 (npapi.h)

  • 發行項

傳回用來存取網路資源之連線的預期效能相關資訊。 要求只能用於目前已連線的網路資源。

語法

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

參數

[in] lpRemoteName

連線資源的本機名稱或遠端名稱的指標。

[out] lpNetConnectInfo

NETCONNECTINFOSTRUCT結構的指標，如果提供者與網路資源有連線，網路提供者就會填入此結構。 除了 cbStructure 欄位以外，此結構的其他所有欄位都會在 MPR 將要求傳遞給網路提供者之前填入零。 因此，提供者必須只寫入具有可用資訊的欄位。 此外，針對速率值，值為 1 表示效能優於單位中可以表示的效能。

傳回的資訊可能是估計值。 如果網路無法取得網路上資源的相關資訊，它可以傳回網路介面卡及其相關效能的相關資訊，然後據以設定 dwFlags 欄位。

傳回值

如果函式成功，它應該會傳回WN_SUCCESS。 否則，它應該會傳回錯誤碼，這可以是下列其中一項。

傳回碼 描述
WN_NOT_CONNECTED
 lpRemoteName 不是連線的網路資源。
WN_NO_NETWORK
 網路不存在。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 npapi.h