Функция OleRegGetMiscStatus (ole2.h)
Возвращает прочие сведения о презентации и поведении, поддерживаемых указанным идентификатором CLSID из реестра.
Эта функция используется разработчиками пользовательских приложений объектов DLL для эмуляции поведения обработчика OLE по умолчанию.
Синтаксис
HRESULT OleRegGetMiscStatus(
[in] REFCLSID clsid,
[in] DWORD dwAspect,
[out] DWORD *pdwStatus
);
Параметры
[in] clsid
CLSID класса, для которого запрашивается информация о состоянии.
[in] dwAspect
Аспект представления класса, для которого запрашивается информация. Возможные значения взяты из перечисления DVASPECT .
[out] pdwStatus
Указатель на переменную, получающую сведения о состоянии.
Возвращаемое значение
Эта функция может возвращать стандартное возвращаемое значение E_OUTOFMEMORY, а также следующие значения.
| Код возврата | Описание |
|---|---|
|
Сведения о состоянии были успешно возвращены. |
|
Для объекта класса не зарегистрирован идентификатор CLSID. |
|
Произошла ошибка при чтении из реестра. |
|
В реестре отсутствует ключ GetMiscStatus . |
Комментарии
Приложения-объекты могут запрашивать OLE для получения сведений о прочих состояниях одним из двух способов. Один из способов — вызвать OleRegGetMiscStatus. Другой — возвращать OLE_S_USEREG в ответ на вызовы обработчиком объектов по умолчанию в IOleObject::GetMiscStatus. OLE_S_USEREG указывает обработчику по умолчанию вызвать OleRegGetMiscStatus. Поскольку приложения объектов DLL не могут возвращать OLE_S_USEREG, они должны вызывать OleRegGetMiscStatus , а не делегировать задание обработчику объектов.
OleRegGetMiscStatus и его одноуровневые функции OleRegGetUserType, OleRegEnumFormatEtc и OleRegEnumVerbs предоставляют разработчикам пользовательских приложений объектов DLL способ эмуляции поведения обработчика объектов OLE по умолчанию при получении сведений об объектах из реестра. Используя эти функции, вы избегаете значительных трудов, выполняемых при написании собственного, и ошибок, присущих работе непосредственно в реестре. Кроме того, вы получите будущие усовершенствования и оптимизации этих функций без необходимости кодировать их самостоятельно.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ole2.h |
| Библиотека | Ole32.lib |
| DLL | Ole32.dll |
| Набор API | ext-ms-win-com-ole32-l1-1-3 (появилась в Windows 10 версии 10.0.10240) |