Функция OleUIChangeIconA (oledlg.h)

  • Статья

Вызывает стандартное диалоговое окно Значок изменения , которое позволяет пользователю выбрать значок из файла значка, исполняемого файла или библиотеки DLL.

Синтаксис

UINT OleUIChangeIconA(
  [in] LPOLEUICHANGEICONA unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру OLEUICHANGEICON для этого диалогового окна.

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

Стандартные определения успешности и ошибок

Код возврата Описание
OLEUI_FALSE
 Неизвестный сбой (неиспользуемый).
OLEUI_OK
 Пользователь нажал кнопку ОК.
OLEUI_SUCCESS
 Ошибка отсутствует, как и OLEUI_OK.
OLEUI_CANCEL
 Пользователь нажал кнопку Отмена.
 

Стандартные ошибки проверки полей

Код возврата Описание
OLEUI_ERR_STANDARDMIN
 Ошибки, общие для всех диалоговых окон, находятся в диапазоне OLEUI_ERR_STANDARDMIN для OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению проверить наличие стандартных сообщений, чтобы отобразить сообщения об ошибках для пользователя.
OLEUI_ERR_STRUCTURENULL
 Указатель на структуру OLEUIXXX, переданную в функцию, имеет значение NULL.
OLEUI_ERR_STRUCTUREINVALID
 Недостаточно разрешений для доступа на чтение или запись к структуре OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
 Неверное значение cbstruct .
OLEUI_ERR_HWNDOWNERINVALID
 Недопустимое значение hWndOwner .
OLEUI_ERR_LPSZCAPTIONINVALID
 Недопустимое значение lpszCaption .
OLEUI_ERR_LPFNHOOKINVALID
 Недопустимое значение lpfnHook .
OLEUI_ERR_HINSTANCEINVALID
 Недопустимое значение hInstance .
OLEUI_ERR_LPSZTEMPLATEINVALID
 Недопустимое значение lpszTemplate .
OLEUI_ERR_HRESOURCEINVALID
 Недопустимое значение hResource .
 

Ошибки инициализации

Код возврата Описание
OLEUI_ERR_FINDTEMPLATEFAILURE
 Не удается найти шаблон диалогового окна.
OLEUI_ERR_LOADTEMPLATEFAILURE
 Не удается загрузить шаблон диалогового окна.
OLEUI_ERR_DIALOGFAILURE
 Сбой инициализации диалогового окна.
OLEUI_ERR_LOCALMEMALLOC
 Сбой вызова LocalAlloc или стандартного распределителя IMalloc .
OLEUI_ERR_GLOBALMEMALLOC
 Сбой вызова GlobalAlloc или стандартного распределителя IMalloc .
OLEUI_ERR_LOADSTRING
 Не удается вызвать LoadString для локализованных ресурсов из библиотеки.
OLEUI_ERR_OLEMEMALLOC
 Сбой вызова стандартного распределителя IMalloc .
 

Ошибки, связанные с функциями

Код возврата Описание
OLEUI_ERR_STANDARDMAX
 Ошибки, общие для всех диалоговых окон, находятся в диапазоне OLEUI_ERR_STANDARDMIN для OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению проверить наличие стандартных сообщений, чтобы отобразить сообщения об ошибках для пользователя.
OLEUI_CIERR_MUSTHAVECLSID
 Элемент clsid не является текущим ИДЕНТИФИКАТОРом CLSID.
OLEUI_CIERR_MUSTHAVECURRENTMETAFILE
 Элемент hMetaPict не является текущим метафайлом.
OLEUI_CIERR_SZICONEXEINVALID
 Недопустимое значение szIconExe .

Комментарии

Структура OLEUICHANGEICON.

Примечание

Заголовок oledlg.h определяет OLEUICHANGEICON в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header oledlg.h
Библиотека OleDlg.lib
DLL OleDlg.dll

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

OLEUICHANGEICON