Функция PathResolve (shlobj_core.h)

Статья
03/02/2024

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

Преобразует относительное или неполное имя пути в полное имя пути.

Синтаксис

int PathResolve(
  [in, out]      PWSTR    pszPath,
  [in, optional] PZPCWSTR dirs,
                 UINT     fFlags
);

Параметры

[in, out] pszPath

Тип: PWSTR

Строка Юникода, завершающаяся нулевым значением, которая содержит путь для разрешения. При возврате функции строка содержит соответствующий полный путь. Этот буфер должен содержать не менее MAX_PATH символов.

[in, optional] dirs

Тип: PZPCWSTR

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

fFlags

Тип: UINT

Флаги, указывающие, как работает функция.

PRF_VERIFYEXISTS

Возвращает значение TRUE , если существование файла проверено; в противном случае — FALSE.

PRF_TRYPROGRAMEXTENSIONS

Найдите указанный путь со следующими расширениями: .pif, .com, .bat, .cmd, .lnk и .exe.

PRF_FIRSTDIRDEF

Сначала найдите каталог или каталоги, указанные dirs.

PRF_DONTFINDLNK

Игнорировать .lnk файлы.

PRF_REQUIREABSOLUTE

Требуется абсолютный (полный) путь.

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

Тип: int

Возвращает значение TRUE, если не задано PRF_VERIFYEXISTS. Если этот флаг установлен, функция возвращает значение TRUE , если файл проверен на существование, и false в противном случае. Он также задает ERROR_FILE_NOT_FOUND код ошибки, который можно получить, вызвав Метод GetLastError.

Возвращаемое значение FALSE не обязательно означает, что файл не существует. Это может означать, что функции просто не удается найти файл из предоставленных сведений.

Если PathResolve не может разрешить путь, указанный в pszPath, он вызывает PathFindOnPath с помощью pszPath и dirs в качестве параметров.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)
Набор API	ext-ms-win-shell-shell32-l1-2-2 (представлено в Windows 10 версии 10.0.14393)

См. также раздел

PathFindOnPath

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