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