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 |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
PathIsSlowW (Unicode) and PathIsSlowA (ANSI) |