Функция SHGetStockIconInfo (shellapi.h)

Извлекает сведения о системных значках оболочки.

Синтаксис

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

Параметры

siid

Тип: SHSTOCKICONID

Одно из значений перечисления SHSTOCKICONID , указывающее, какой значок следует извлечь.

uFlags

Тип: UINT

Сочетание нулевых или более следующих флагов, указывающих, какие сведения запрашивается.

SHGSI_ICONLOCATION

Члены szPath и iIcon структуры SHSTOCKICONINFO получают путь и индекс значка запрошенного значка в формате, подходящем для передачи функции ExtractIcon . Числовое значение этого флага равно нулю, поэтому вы всегда получаете расположение значка независимо от других флагов.

SHGSI_ICON

Элемент hIcon структуры SHSTOCKICONINFO получает дескриптор указанного значка.

SHGSI_SYSICONINDEX

Элемент iSysImageImage структуры SHSTOCKICONINFO получает индекс указанного значка в системном списке образов.

SHGSI_LINKOVERLAY

Изменяет значение SHGSI_ICON путем добавления функции наложения ссылки на значок файла.

SHGSI_SELECTED

Изменяет значение SHGSI_ICON путем смешивания значка с цветом выделения системы.

SHGSI_LARGEICON

Изменяет значение SHGSI_ICON путем получения функции большой версии значка, как указано SM_CXICON и системных метрик SM_CYICON.

SHGSI_SMALLICON

Изменяет значение SHGSI_ICON, вызывая функцию для получения небольшой версии значка, как указано в SM_CXSMICON и SM_CYSMICON системных метрик.

SHGSI_SHELLICONSIZE

Изменяет значения SHGSI_LARGEICON или SHGSI_SMALLICON путем получения значков размера оболочки, а не размеров, указанных системными метриками.

[in, out] psii

Тип: SHSTOCKICONINFO*

Указатель на структуру SHSTOCKICONINFO . При вызове этой функции необходимо задать для элемента cbSize этой структуры размер структуры SHSTOCKICONINFO . При возврате этой функции содержит указатель на структуру SHSTOCKICONINFO , содержащую запрошенные сведения.

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

Тип: HRESULT

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

Замечания

Если эта функция возвращает дескриптор значка в элементе hIcon структуры SHSTOCKICONINFO , на которую указывает psii, вы несете ответственность за освобождение значка с помощью DestroyIcon , если вам больше не нужно.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
Набор API	ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)