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

Статья
08/25/2023

Вызывает диалоговое окно Свойства объекта, в котором отображаются сведения об объекте "Общие", "Представление" и "Ссылка".

Синтаксис

UINT OleUIObjectPropertiesA(
  [in] LPOLEUIOBJECTPROPSA unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру OLEUIOBJECTPROPS .

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

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

Код возврата	Описание
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_OPERR_SUBPROPNULL	lpGP или lpVP имеет значение NULL, или dwFlags и OPF_OBJECTISLINK и lpLP имеют значение NULL.
OLEUI_OPERR_SUBPROPINVALID	Недостаточно разрешений на запись для структур, на которые указывают lpGP, lpVP или lpLP.
OLEUI_OPERR_PROPSHEETNULL	Значение lpLP равно NULL.
OLEUI_OPERR_PROPSHEETINVALID	Недостаточно разрешений на запись для структур, на которые указывают lpGP, lpVP или lpLP.
OLEUI_OPERR_SUPPROP	Указатель свойства вложенной ссылки, lpLP, имеет значение NULL.
OLEUI_OPERR_PROPSINVALID	Недостаточный доступ на запись для указателя свойства вложенной ссылки, lpLP.
OLEUI_OPERR_PAGESINCORRECT	Некоторые свойства вложенных ссылок элемента lpPS неверны.
OLEUI_OPERR_INVALIDPAGES	Некоторые свойства вложенных ссылок элемента lpPS неверны.
OLEUI_OPERR_NOTSUPPORTED	Неверное свойство вложенной ссылки элемента lpPS .
OLEUI_OPERR_DLGPROCNOTNULL	Неверное свойство вложенной ссылки элемента lpPS .
OLEUI_OPERR_LPARAMNOTZERO	Неверное свойство вложенной ссылки элемента lpPS .
OLEUI_GPERR_STRINGINVALID	Строковое значение (например, lplpszLabel или lplpszType) является недопустимым.
OLEUI_GPERR_CLASSIDINVALID	Недопустимое значение clsid .
OLEUI_GPERR_LPCLSIDEXCLUDEINVALID	Недопустимое значение ClsidExcluded .
OLEUI_GPERR_CBFORMATINVALID	Недопустимое значение wFormat .
OLEUI_VPERR_METAPICTINVALID	Недопустимое значение hMetaPict .
OLEUI_VPERR_DVASPECTINVALID	Недопустимое значение dvAspect .
OLEUI_OPERR_PROPERTYSHEET	Неверное значение lpPS .
OLEUI_OPERR_OBJINFOINVALID	Значение lpObjInfo равно NULL , или вызывающий процесс не имеет доступа на чтение.
OLEUI_OPERR_LINKINFOINVALID	Значение lpLinkInfo равно NULL или вызывающий процесс не имеет доступа на чтение.

OleUIObjectProperties передает структуру OLEUIOBJECTPROPS , которая предоставляет сведения, необходимые для заполнения на вкладках Общие, Представление и Ссылка диалогового окна Свойства объекта .

Примечание

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

Требования

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