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

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

  • Статья

Вызывает стандартное диалоговое окно Преобразование , позволяющее пользователю изменить тип одного указанного объекта или тип всех объектов OLE класса указанного объекта.

Синтаксис

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру OLEUICONVERT , содержащую сведения, используемые для инициализации диалогового окна.

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

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

Код возврата Описание
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_CTERR_CLASSIDINVALID
 Недопустимое значение clsid .
OLEUI_CTERR_DVASPECTINVALID
 Недопустимое значение dvAspect . Этот элемент указывает аспект объекта .
OLEUI_CTERR_CBFORMATINVALID
 Недопустимое значение wFormat . Этот элемент задает формат данных объекта .
OLEUI_CTERR_STRINGINVALID
 Строковое значение (например, lpszUserType или lpszDefLabel) было недопустимым.

Комментарии

OleUIConvert заполняет список диалогового окна Преобразование классами объектов, просматривая реестр и просматривая записи в ключах Readable и ReadWritable. Каждый класс, содержащий формат файла исходного класса по умолчанию в ключе Readable, добавляется в список Convert, а каждый класс, содержащий формат файла исходного класса по умолчанию в ключе ReadWritable, добавляется в список Активировать как. Список Преобразовать отображается в диалоговом окне при выборе переключателя Преобразовать (выбор по умолчанию), а список Активировать как отображается при выборе параметра Активировать как .

Обратите внимание, что изменить тип всех объектов данного класса можно только в том случае, если CF_CONVERTONLY не указан.

Команда convert, которая вызывает эту функцию, должна быть доступна пользователю только в том случае, если OleUICanConvertOrActivateAs возвращает S_OK.

Примечание

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

Требования

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

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

OLEUICONVERT

OleUICanConvertOrActivateAs