PathIsSlowW-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 PathIsSlowW(
  [in] LPCWSTR 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)