PathIsSlowA 関数 (shlobj.h)

  • [アーティクル]

[PathIsSlow は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

ファイル パスが待機時間の長いネットワーク接続であるかどうかを判断します。

構文

BOOL PathIsSlowA(
  [in] LPCSTR pszFile,
       DWORD  dwAttr
);

パラメーター

[in] pszFile

型: LPCTSTR

ファイルの完全修飾パスを含む null で終わる文字列へのポインター。

dwAttr

型: DWORD

ファイル属性 (既知の場合)。それ以外の場合は、–1 を渡し、この関数は GetFileAttributes を呼び出して属性を取得します。 ファイル属性の一覧については、「 GetFileAttributes 」を参照してください。

戻り値

種類: BOOL

接続の待機時間が長い場合は TRUE を 返します。それ以外の場合は FALSE。

注釈

MultinetGetConnectionPerformance 関数が NETCONNECTINFOSTRUCT 構造体で 400 以下の dwSpeed を返す場合、パスは低速と見なされます。これは、ネットワーク リソースへのメディアの速度 (100 ビット/秒 (bps) 単位)、またはファイルにFILE_ATTRIBUTE_OFFLINEが設定されている場合です。

ネットワークの状態は、関数のパフォーマンス時間に影響を与える可能性があることに注意してください。

注意

shlobj.h ヘッダーは PathIsSlow をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shlobj.h
Library Shell32.lib
[DLL] Shell32.dll (バージョン 5.0 以降)