Función OleCreateDefaultHandler (ole2.h)

Crea una nueva instancia del controlador de inserción predeterminado. Esta instancia se inicializa para que cree un servidor local cuando el objeto incrustado entre en estado de ejecución.

Sintaxis

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

Parámetros

[in] clsid

CLSID que identifica el servidor OLE que se va a cargar cuando el objeto incrustado entra en estado de ejecución.

[in] pUnkOuter

Puntero a la interfaz IUnknown de control si se va a agregar el controlador; NULL si no se va a agregar.

[in] riid

Referencia al identificador de la interfaz, normalmente IID_IOleObject, a través del cual el autor de la llamada se comunicará con el controlador.

[out] lplpObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvObj contiene el puntero de interfaz solicitado en el controlador recién creado.

Valor devuelto

Esta función devuelve NOERROR si se ejecuta correctamente y admite el valor devuelto estándar E_OUTOFMEMORY.

Comentarios

OleCreateDefaultHandler crea una nueva instancia del controlador de inserción predeterminado, inicializado para crear un servidor local identificado por el parámetro clsid cuando el objeto incrustado entra en estado de ejecución. Si va a escribir un controlador y desea usar los servicios del controlador predeterminado, llame a OleCreateDefaultHandler. OLE también lo llama internamente cuando el CLSID especificado en una llamada de creación de objetos no está registrado.

Si la clase especificada no tiene un controlador especial, una llamada a OleCreateDefaultHandler genera los mismos resultados que una llamada a la función CoCreateInstance con el parámetro de contexto de clase asignado al valor CLSCTX_INPROC_HANDLER.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ole2.h
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

CLSCTX

Cocreateinstance