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

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

  • Статья

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

Синтаксис

UINT OleUIChangeIconW(
  [in] LPOLEUICHANGEICONW 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка oledlg.h
библиотеки OleDlg.lib
DLL OleDlg.dll

См. также

OLEUICHANGEICON