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 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

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