Функция PathIsNetworkPathW (shlwapi.h)

Статья
11/20/2024

Определяет, представляет ли строка пути сетевой ресурс.

Синтаксис

BOOL PathIsNetworkPathW(
  [in] LPCWSTR pszPath
);

Параметры

[in] pszPath

Тип: LPCTSTR

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

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

Тип: BOOL

Возвращает TRUE, если строка представляет сетевой ресурс или FALSE в противном случае.

Замечания

PathIsNetworkPath интерпретирует следующие два типа путей как сетевые пути.

Пути, начинающиеся с двух символов обратной косой черты (\\), интерпретируются как пути универсального соглашения об именовании (UNC).
Пути, начинающиеся с буквы, за которой следует двоеточие (:) интерпретируются как подключенный сетевой диск. Однако PathIsNetworkPath не может распознать сетевой диск, сопоставленный с буквой диска, с помощью команды SUBST Майкрософт MS-DOS или функции DefineDosDevice.

Примечание Функция не проверяет, существует ли указанный сетевой ресурс, в настоящее время доступен или у пользователя есть достаточные разрешения для доступа к нему.

Заметка

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

Требования

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

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