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

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

  • Статья

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

Синтаксис

UINT OleUIConvertW(
  [in] LPOLEUICONVERTW 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. Каждый класс, включающий формат файла по умолчанию исходного класса в его доступный для чтения ключ, добавляется в список Convert, и каждый класс, включающий формат файла по умолчанию исходного класса в его ключе ReadWritable, добавляется в список "Активировать как". Список преобразования отображается в списке диалогового окна при выборе переключателя преобразования (выбор по умолчанию), а список "Активировать как" отображается при выборе активации как.

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

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

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка oledlg.h
библиотеки OleDlg.lib
DLL OleDlg.dll

См. также

OLEUICONVERT

OleUICanConvertOrActivateAs