ネットワーク リソースにアクセスするために使用される接続の予想されるパフォーマンスに関する情報を返します。 要求は、現在接続されているネットワーク リソースに対してのみ行うことができます。
構文
DWORD NPGetConnectionPerformance(
[in] LPCWSTR lpRemoteName,
[out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);
パラメーター
[in] lpRemoteName
接続されているリソースのローカル名またはリモート名へのポインター。
[out] lpNetConnectInfo
NETCONNECTINFOSTRUCT 構造体へのポインター。プロバイダーがネットワーク リソースに接続している場合、ネットワーク プロバイダーによって入力されます。 この構造体の他のすべてのフィールド ( cbStructure フィールドを除く) は、MPR がネットワーク プロバイダーに要求を渡す前にゼロで埋められます。 その結果、プロバイダーは情報が使用可能なフィールドにのみ書き込む必要があります。 また、レート値の場合、値 1 は、単位で表すことができるよりもパフォーマンスが優れていることを意味します。
返される情報は見積もりである可能性があります。 ネットワークがネットワーク上のリソースに関する情報を取得できない場合は、ネットワーク アダプターとその関連するパフォーマンスに関する情報を返し、それに応じて dwFlags フィールドを設定できます。
戻り値
関数が成功すると、WN_SUCCESSが返されます。 それ以外の場合は、次のいずれかのエラー コードを返す必要があります。
| リターン コード | Description |
|---|---|
|
lpRemoteName は、接続されているネットワーク リソースではありません。 |
|
ネットワークが存在しません。 |
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | npapi.h |
| Library | nanosrv.lib |