Функция PathIsSlowW (shlobj.h)

Статья
11/20/2024

[PathIsSlow доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях.]

Определяет, является ли путь к файлу сетевым подключением с высокой задержкой.

Синтаксис

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

Параметры

[in] pszFile

Тип: LPCTSTR

Указатель на строку, завершающую значение NULL, содержащую полный путь к файлу.

dwAttr

Тип: DWORD

Атрибуты файла, если известны; в противном случае передайте –1 и эта функция получает атрибуты путем вызова GetFileAttributes. Список атрибутов файла см. в GetFileAttributes.

Возвращаемое значение

Тип: BOOL

Возвращает TRUE, если подключение имеет высокую задержку; в противном случае FALSE.

Замечания

Путь считается медленным, если функция MultinetGetConnectionPerformance возвращает dwSpeed 400 или меньше в своей структуре NETCONNECTINFOSTRUCT — это скорость носителя к сетевому ресурсу в 100 бит в секунду или если FILE_ATTRIBUTE_OFFLINE установлен в файле.

Обратите внимание, что сетевые условия могут повлиять на время производительности функции.

Заметка

Заголовок shlobj.h определяет PathIsSlow как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj.h
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя версия)

Поделиться через