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

  • Статья

Создает новый экземпляр обработчика внедрения по умолчанию. Этот экземпляр инициализируется таким образом, что он создает локальный сервер, когда внедренный объект переходит в состояние выполнения.

Синтаксис

HRESULT OleCreateDefaultHandler(
  [in]  REFCLSID  clsid,
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFIID    riid,
  [out] LPVOID    *lplpObj
);

Параметры

[in] clsid

CLSID идентифицирует OLE-сервер, который нужно загрузить, когда внедренный объект переходит в состояние выполнения.

[in] pUnkOuter

Указатель на управляющий интерфейс IUnknown , если обработчик должен быть агрегирован; Значение NULL , если не требуется агрегировать.

[in] riid

Ссылка на идентификатор интерфейса, как правило, IID_IOleObject, с помощью которого вызывающий объект будет взаимодействовать с обработчиком.

[out] lplpObj

Адрес переменной указателя, получающей указатель интерфейса, запрошенный в riid. После успешного возврата *ppvObj содержит запрошенный указатель интерфейса на только что созданный обработчик.

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

Эта функция возвращает NOERROR при успешном выполнении и поддерживает стандартное возвращаемое значение E_OUTOFMEMORY.

Комментарии

OleCreateDefaultHandler создает новый экземпляр обработчика внедрения по умолчанию, инициализированный таким образом, что он создает локальный сервер, идентифицируемый параметром clsid , когда внедренный объект переходит в состояние выполнения. Если вы пишете обработчик и хотите использовать службы обработчика по умолчанию, вызовите OleCreateDefaultHandler. OLE также вызывает его внутренне, если идентификатор CLSID, указанный в вызове создания объекта, не зарегистрирован.

Если у данного класса нет специального обработчика, вызов OleCreateDefaultHandler дает те же результаты, что и вызов функции CoCreateInstance с параметром контекста класса, присвоенным значению CLSCTX_INPROC_HANDLER.

Требования

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

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

CLSCTX

CoCreateInstance