Expand Minimize

PathIsSlow function

[PathIsSlow is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Determines whether a file path is a high-latency network connection.

Syntax


BOOL PathIsSlow(
  _In_  LPCTSTR pszFile,
  DWORD dwFileAttr
);

Parameters

pszFile [in]

Type: LPCTSTR

A pointer to a null-terminated string that contains the fully qualified path of the file.

dwFileAttr

Type: DWORD

The file attributes, if known; otherwise, pass –1 and this function gets the attributes by calling GetFileAttributes. See GetFileAttributes for a list of file attributes.

Return value

Type: BOOL

Returns TRUE if the connection is high-latency; otherwise, FALSE.

Remarks

A path is considered slow if the MultinetGetConnectionPerformance function returns a dwSpeed of 400 or less in its NETCONNECTINFOSTRUCT structure—this is the speed of the media to the network resource, in 100 bits-per-second (bps)—or if FILE_ATTRIBUTE_OFFLINE is set on the file.

Note that network conditions can impact function performance time.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows Vista

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

Unicode and ANSI names

PathIsSlowW (Unicode) and PathIsSlowA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft