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

Метод IAssocHandler::GetIconLocation (shobjidl_core.h)

  • Статья

Извлекает расположение значка, связанного с приложением.

Синтаксис

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

Параметры

[out] ppszPath

Тип: LPWSTR*

При возврате этого метода содержит адрес указателя на строку Юникода, завершающуюся null, которая содержит путь к значку приложения.

[out] pIndex

Тип: int*

При возврате этого метода содержит указатель на индекс значка в ресурсе с именем в ppszPath.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

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

По соображениям производительности приложение может использовать кэш образов оболочки для получения значка, а не загружать значок непосредственно из возвращенного пути. Путь и индекс значка можно передать непосредственно Shell_GetCachedImageIndex. Одним из преимуществ этого является то, что кэш оболочки может предоставить значок по умолчанию в случае, если значок не был доступен для приложения.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)