MultinetGetConnectionPerformanceW 関数 (winnetwk.h)
MultinetGetConnectionPerformance 関数は、ネットワーク リソースへのアクセスに使用される接続の予想されるパフォーマンスに関する情報を返します。
構文
DWORD MultinetGetConnectionPerformanceW(
[in] LPNETRESOURCEW lpNetResource,
[out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);
パラメーター
[in] lpNetResource
ネットワーク リソースを指定する NETRESOURCE 構造体へのポインター。 次のメンバーは、このコンテキストで特定の意味を持ちます。
[out] lpNetConnectInfoStruct
データを受け取る NETCONNECTINFOSTRUCT 構造体へのポインター。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は システム エラー コード(次のいずれかの値など) です。
| リターン コード | 形容 |
|---|---|
|
ネットワーク リソースはこの情報を提供しません。 |
|
|
|
ネットワーク コンポーネントが開始されていないか、指定されたリソース名が認識されないために、操作を完了できませんでした。 |
|
lpLocalName メンバーによって指定されたローカル デバイスが無効です。 |
|
ネットワーク名が見つかりません。 このエラーは、 |
|
無効なアドレスにアクセスしようとしました。 このエラーは、 |
|
無効なパラメーターが渡されました。 このエラーは、lpNetConnectInfoStruct パラメーターが、cbStructure メンバーが適切な構造体サイズで満たされている NETCONNECTINFOSTRUCT 構造体を指していない場合に返されます。 |
|
ネットワークは使用できません。 |
|
ネットワーク固有のエラーが発生しました。 エラーの説明を取得するには、WNetGetLastError |
備考
MultinetGetConnectionPerformance 関数は、NETCONNECTINFOSTRUCT 構造体内の情報を返します。
MultinetGetConnectionPerformance 関数によって返される情報は見積もりのみです。 ネットワーク トラフィックとルーティングは、返される結果の精度に影響を与える可能性があります。
MultinetGetConnectionPerformance 関数は、ネットワーク リソースにリダイレクトされるローカル デバイスまたは現在接続されているネットワーク リソースの情報を要求する場合にのみ使用できます。
この関数を使用する一般的な方法は、ネットワーク サーバー上のファイルを開き (ファイルへの接続があることを保証する)、この関数を呼び出し、結果を使用してファイル I/O を管理する方法を決定することです。 たとえば、ファイル全体をクライアント上の一時ファイルに読み込むか、サーバー上のファイルに直接アクセスするかを決定できます。
手記
winnetwk.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MultinetGetConnectionPerformance を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winnetwk.h |
| ライブラリ | Mpr.lib |
| DLL | Mpr.dll |
関連項目
NETRESOURCE の