Função PathIsSlowW (shlobj.h)

[PathIsSlow está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Determina se um caminho de arquivo é uma conexão de rede de alta latência.

Sintaxe

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

Parâmetros

[in] pszFile

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho totalmente qualificado do arquivo.

dwAttr

Tipo: DWORD

Os atributos de arquivo, se conhecidos; caso contrário, passe –1 e essa função obterá os atributos chamando GetFileAttributes. Consulte GetFileAttributes para obter uma lista de atributos de arquivo.

Retornar valor

Tipo: BOOL

Retornará TRUE se a conexão for de alta latência; caso contrário, FALSE.

Comentários

Um caminho será considerado lento se a função MultinetGetConnectionPerformance retornar um dwSpeed de 400 ou menos em sua estrutura NETCONNECTINFOSTRUCT — essa é a velocidade da mídia para o recurso de rede, em 100 bits por segundo (bps)— ou se FILE_ATTRIBUTE_OFFLINE estiver definido no arquivo.

Observe que as condições de rede podem afetar o tempo de desempenho da função.

Observação

O cabeçalho shlobj.h define PathIsSlow como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj.h
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)