Метод IShellLinkA::GetPath (shobjidl_core.h)

Статья
08/26/2023

Возвращает путь и имя файла целевого объекта ссылки оболочки.

Синтаксис

HRESULT GetPath(
  [out]     LPSTR            pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAA *pfd,
  [in]      DWORD            fFlags
);

Параметры

[out] pszFile

Тип: LPTSTR

Адрес буфера, получающего путь и имя файла целевого объекта ссылки оболочки.

[in] cch

Тип: int

Размер (в символах) буфера, на который указывает параметр pszFile , включая завершающий символ NULL. Максимальный размер пути, который можно вернуть, MAX_PATH. Этот параметр обычно задается путем вызова ARRAYSIZE(pszFile). Макрос ARRAYSIZE определен в Winnt.h.

[in, out] pfd

Тип: WIN32_FIND_DATA*

Указатель на структуру WIN32_FIND_DATA , получающую сведения о целевом объекте ссылки оболочки. Если этот параметр имеет значение NULL, дополнительные сведения не возвращаются.

[in] fFlags

Тип: DWORD

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

SLGP_SHORTPATH

Извлекает стандартное короткое имя файла (формат 8.3).

SLGP_UNCPRIORITY

Неподдерживаемые; не использовать.

SLGP_RAWPATH

Извлекает имя необработанного пути. Необработанный путь — это то, что может не существовать и может включать переменные среды, которые необходимо развернуть.

SLGP_RELATIVEPRIORITY

Windows Vista и более поздних версий. По возможности извлекает путь целевого объекта ярлыка относительно пути, заданного предыдущим вызовом IShellLink::SetRelativePath.

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

Тип: HRESULT

Возвращает S_OK , если операция выполнена успешно и получен допустимый путь. Если операция выполнена успешно, но путь не получен, возвращается S_FALSE и pszFile будет пустым. В противном случае возвращается одно из стандартных значений ошибки HRESULT.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h
DLL	Shell32.dll (версия 4.0 или более поздняя)