OleCreateDefaultHandler
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.
WINOLEAPI OleCreateDefaultHandler(
|
REFCLSID clsid, |
//OLE server to be loaded |
|
LPUNKNOWN pUnkOuter, |
//Pointer to controlling IUnknown if aggregated;
else NULL |
|
REFIID riid, |
//Reference to the identifier of the interface for
communicating with handler |
|
LPVOID FAR * ppvObj |
//Indirect pointer to interface on handler |
|
); |
|
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.
ppvObj
[out]
Indirect pointer to the interface requested in riid on the newly created
handler.
Return Values
This function
supports the standard return value E_OUTOFMEMORY, as well as the following:
NOERROR
The creation
operation was successful.
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.
See Also