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 |