OleCreateEmbeddingHelperCreates an OLE embedding helper object using application-supplied code aggregated with pieces of the OLE default object handler. This helper object can be created and used in a specific context and role, as determined by the caller. HRESULT OleCreateEmbeddingHelper(
| REFCLSID clsid,
||//The ID of the class to be helped
| LPUNKNOWN pUnkOuter,
||//Points to controlling IUnknown
| DWORD flags,
||//Specifies the purpose for the helper
| LPCLASSFACTORY pCF,
||//Points to IClassFactory instance
| REFIID riid,
||//The ID of the interface sought by caller
| LPVOID * lplpvObj
||//Points to return point for helper
- An object application that is being used as both a container and a server, and which supports inserting objects into itself. In this case, the application registers its CLSID for different contexts by calling the CoRegisterClassObject function and specifying CLSCTX_LOCAL_SERVER | CLSCTX_INPROC_SERVER as the dwClsctx parameter, and REGCLS_MULTI_SEPARATE as the flags parameter. The local class is used to create the object and the in-process class creates the embedding helper, passing in the pointer to the first object's class factory in pCF.
- An in-process object handler, in which case, the DLL creates the embedding helper by passing in a pointer to a private implementation of IClassFactory in pCF.
|Values for flags Parameter
||Creates an embedding helper that can be used with DLL object applications;
specifically, the helper exposes the caching features of the default object
||Creates an embedding helper that can be used with in-process servers.
||EMBDHLP_CREATENOW creates the application-supplied piece of the object
||EMBDHLP_DELAYCREATE delays creating the application-supplied piece of the
object until the object is put into its running state.
(clsid, pUnkOuter, EMBDHLP_INPROC_HANDLER | EMBDHLP_CREATENOW,
NULL, riid, ppvObj) is the same as calling OleCreateDefaultHandler(clsid, pUnkOuter, riid, ppvObj) See Also OleCreateDefaultHandler
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages