Win32 API 日本語リファレンス
ホーム › NetworkManagement.WNet › PF_NPGetConnectionPerformance

PF_NPGetConnectionPerformance

コールバック

シグネチャ

DWORD PF_NPGetConnectionPerformance(
    LPWSTR lpRemoteName,
    NETCONNECTINFOSTRUCT* lpNetConnectInfo
);

パラメーター

フィールド型説明
lpRemoteNameLPWSTR接続されているリソースのローカル名またはリモート名へのポインターです。
lpNetConnectInfoNETCONNECTINFOSTRUCT*

NETCONNECTINFOSTRUCT 構造体へのポインターです。ネットワークプロバイダーが該当のネットワークリソースへの接続を持っている場合、この構造体はそのプロバイダーによって設定されます。MPR が要求をネットワークプロバイダーに渡す前に、この構造体の cbStructure フィールドを除くすべてのフィールドはゼロで埋められます。そのためプロバイダーは、情報が得られるフィールドにのみ書き込めば済みます。また、レートを表す値では、値 1 はその単位で表現できる範囲を超えてパフォーマンスが良いことを意味します。

返される情報は推定値の場合があります。ネットワーク上のリソースに関する情報を取得できない場合は、ネットワークアダプターとそれに関連するパフォーマンスの情報を返し、それに応じて dwFlags フィールドを設定できます。

公式ドキュメント

ネットワークリソースへのアクセスに使用される接続について、想定されるパフォーマンスに関する情報を返します。要求できるのは、現在接続されているネットワークリソースに対するものだけです。

戻り値

関数が成功した場合は WN_SUCCESS を返します。失敗した場合は、次のいずれかのエラーコードを返します。

戻り値 説明
WN_NOT_CONNECTED
 lpRemoteName が、接続されているネットワークリソースではありません。
WN_NO_NETWORK
 ネットワークが存在しません。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)