Funzione PathIsSlowA (shlobj.h)

Articolo
11/20/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 PathIsSlowA(
  [in] LPCSTR pszFile,
       DWORD  dwAttr
);

Parametri

[in] pszFile

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null contenente 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. Vedere GetFileAttributes per un elenco di attributi di file.

Valore restituito

Tipo: bool

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

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlobj.h
libreria	Shell32.lib
dll	Shell32.dll (versione 5.0 o successiva)

Condividi tramite