PathIsSlowW-Funktion (shlobj.h)

Artikel
11/20/2024

[PathIsSlow steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. 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 mit Null beendete Zeichenfolge, die den vollqualifizierten Pfad der Datei enthält.

dwAttr

Typ: DWORD-

Die Dateiattribute, sofern bekannt; andernfalls übergeben Sie –1, und diese Funktion ruft die Attribute ab, indem Sie GetFileAttributesaufrufen. 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.

Bemerkungen

Ein Pfad wird als langsam betrachtet, wenn die MultinetGetConnectionPerformance-Funktion eine dwSpeed von 400 oder weniger in seiner NETCONNECTINFOSTRUCT- Struktur zurückgibt – dies ist die Geschwindigkeit der Medien für die Netzwerkressource in 100 Bits pro Sekunde (bps) oder wenn FILE_ATTRIBUTE_OFFLINE in der Datei festgelegt ist.

Beachten Sie, dass sich die Netzwerkbedingungen auf die Funktionsleistung auswirken können.

Anmerkung

Der Shlobj.h-Header definiert PathIsSlow als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlobj.h
Library	Shell32.lib
DLL-	Shell32.dll (Version 5.0 oder höher)

Freigeben über