Funzione PathIsSlowW (shlobj.h)

Articolo
03/05/2024

[PathIsSlow è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Determina se un percorso di file è una connessione di rete a latenza elevata.

Sintassi

BOOL PathIsSlowW(
  [in] LPCWSTR pszFile,
       DWORD   dwAttr
);

Parametri

[in] pszFile

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che contiene il percorso completo del file.

dwAttr

Tipo: DWORD

Attributi del file, se noti; in caso contrario, passare –1 e questa funzione ottiene gli attributi chiamando GetFileAttributes. Per un elenco di attributi di file, vedere GetFileAttributes .

Valore restituito

Tipo: BOOL

Restituisce TRUE se la connessione è ad alta latenza; in caso contrario, FALSE.

Commenti

Un percorso viene considerato lento se la funzione MultinetGetConnectionPerformance restituisce un valore dwSpeed pari o inferiore a 400 nella struttura NETCONNECTINFOSTRUCT , ovvero la velocità del supporto alla risorsa di rete, in 100 bit al secondo (bps) o se FILE_ATTRIBUTE_OFFLINE è impostato nel file.

Si noti che le condizioni di rete possono influire sul tempo di prestazioni delle funzioni.

Nota

L'intestazione shlobj.h definisce PathIsSlow come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite