Метод 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. Одним из преимуществ этого является то, что кэш оболочки может предоставить значок по умолчанию в случае, если значок не был доступен для приложения.

Требования