Função PathIsSlowA (shlobj.h)

Artigo
11/20/2024

[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 PathIsSlowA(
  [in] LPCSTR 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 obtém os atributos chamando GetFileAttributes. Consulte GetFileAttributes para obter uma lista de atributos de arquivo.

Valor de retorno

Tipo: BOOL

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

Observações

Um caminho será considerado lento se a função MultinetGetConnectionPerformance retornar um dwSpeed de 400 ou menos em seu estrutura de 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via