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 结构中返回的 dwSpeed 为 400 或更少,则路径将被视为缓慢—这是媒体到网络资源的速度(以每秒 100 位(bps)为单位),或者是否在文件中设置了FILE_ATTRIBUTE_OFFLINE。

请注意,网络条件可能会影响函数性能时间。

注意

shlobj.h 标头将 PathIsSlow 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 shlobj.h
Shell32.lib
DLL Shell32.dll (版本 5.0 或更高版本)