Функция OleRegGetUserType (ole2.h)

Возвращает тип пользователя указанного класса из реестра.

Разработчики пользовательских приложений объектов DLL используют эту функцию для эмуляции поведения обработчика OLE по умолчанию.

Синтаксис

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Параметры

[in] clsid

CLSID класса, для которого требуется запросить тип пользователя.

[in] dwFormOfType

Форма пользовательской строки. Возможные значения взяты из перечисления USERCLASSTYPE.

[out] pszUserType

Указатель на строку, которая получает тип пользователя.

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

Эта функция может возвращать стандартное возвращаемое значение E_OUTOFMEMORY, а также следующие значения.

Комментарии

Объектные приложения могут запросить у OLE имя типа пользователя указанного класса одним из двух способов. Один из способов — вызвать OleRegGetUserType. Другой — возврат OLE_S_USEREG в ответ на вызовы обработчика объектов по умолчанию в IOleObject::GetUserType. OLE_S_USEREG указывает обработчику по умолчанию вызвать OleRegGetUserType. Поскольку приложения объектов DLL не могут возвращать OLE_S_USEREG, они должны вызывать OleRegGetUserType, а не делегировать задание обработчику объектов.

Функция OleRegGetUserType и ее одноуровневые функции OleRegGetMiscStatus, OleRegEnumFormatEtc и OleRegEnumVerbs предоставляют разработчикам пользовательских приложений объектов DLL способ эмулировать поведение обработчика объектов OLE по умолчанию при получении сведений об объектах из реестра. Используя эти функции, вы избегаете значительных усилий по написанию собственных и ловушек, присущих работе непосредственно в реестре. Кроме того, вы получаете будущие усовершенствования и оптимизации этих функций без необходимости написания кода самостоятельно.

Требования

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

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus