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.]
Applies to: desktop apps only
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 |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
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) |
Send comments about this topic to Microsoft
Build date: 3/7/2012
