EN
Este contenido no se encuentra disponible en su idioma, pero aquí tiene la versión en inglés.

OleCreateDefaultHandler function

Creates a new instance of the default embedding handler. This instance is initialized so it creates a local server when the embedded object enters the running state.

Syntax


HRESULT OleCreateDefaultHandler(
  _In_   REFCLSID clsid,
  _In_   LPUNKNOWN pUnkOuter,
  _In_   REFIID riid,
  _Out_  LPVOID *lplpObj
);

Parameters

clsid [in]

CLSID identifying the OLE server to be loaded when the embedded object enters the running state.

pUnkOuter [in]

Pointer to the controlling IUnknown interface if the handler is to be aggregated; NULL if it is not to be aggregated.

riid [in]

Reference to the identifier of the interface, usually IID_IOleObject, through which the caller will communicate with the handler.

lplpObj [out]

Address of pointer variable that receives the interface pointer requested in riid. Upon successful return, *ppvObj contains the requested interface pointer on the newly created handler.

Return value

This function returns NOERROR on success and supports the standard return value E_OUTOFMEMORY.

Remarks

OleCreateDefaultHandler creates a new instance of the default embedding handler, initialized so it creates a local server identified by the clsid parameter when the embedded object enters the running state. If you are writing a handler and want to use the services of the default handler, call OleCreateDefaultHandler. OLE also calls it internally when the CLSID specified in an object creation call is not registered.

If the given class does not have a special handler, a call to OleCreateDefaultHandler produces the same results as a call to the CoCreateInstance function with the class context parameter assigned the value CLSCTX_INPROC_HANDLER.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ole2.h

Library

Ole32.lib

DLL

Ole32.dll

See also

CoCreateInstance
CLSCTX

 

 

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft