PathIsSlowA-Funktion (shlobj.h)
[PathIsSlow ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Bestimmt, ob ein Dateipfad eine Netzwerkverbindung mit hoher Latenz ist.
Syntax
BOOL PathIsSlowA(
[in] LPCSTR pszFile,
DWORD dwAttr
);
Parameter
[in] pszFile
Typ: LPCTSTR
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den vollqualifizierten Pfad der Datei enthält.
dwAttr
Art: DWORD
Die Dateiattribute, sofern bekannt; Andernfalls übergeben Sie –1, und diese Funktion ruft die Attribute durch Aufrufen von GetFileAttributes ab. Eine Liste der Dateiattribute finden Sie unter GetFileAttributes .
Rückgabewert
Typ: BOOL
Gibt TRUE zurück, wenn die Verbindung eine hohe Latenz aufweist. andernfalls FALSE.
Hinweise
Ein Pfad wird als langsam angesehen, wenn die MultinetGetConnectionPerformance-Funktion in ihrer NETCONNECTINFOSTRUCT-Struktur eine dwSpeed von 400 oder weniger zurückgibt – dies ist die Geschwindigkeit der Medien zur Netzwerkressource in 100 Bits pro Sekunde (bps) oder wenn FILE_ATTRIBUTE_OFFLINE für die Datei festgelegt ist.
Beachten Sie, dass sich Netzwerkbedingungen auf die Funktionsleistungszeit auswirken können.
Hinweis
Der shlobj.h-Header definiert PathIsSlow als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlobj.h |
Bibliothek | Shell32.lib |
DLL | Shell32.dll (Version 5.0 oder höher) |