ISurrogate::LoadDllServer (Windows CE 5.0)
This method loads a DLL server into the implementing surrogate. COM calls this method when there is an activation request for the DLL server's class, if the class is registered as DllSurrogate.
HRESULT LoadDllServer(REFCLSIDClsid);
Parameters
- Clsid
[in] CLSID of the DLL server to be loaded.
Return Values
This method supports the standard return values E_UNEXPECTED, E_OUTOFMEMORY, and E_INVALIDARG.
If the method succeeds, the return value is S_OK.
Remarks
Upon receiving a load request through ISurrogate::LoadDllServer, the surrogate must perform the following steps:
- Create a class factory object that supports the IUnknown, IClassFactory, and IMarshal interfaces.
- Call the CoRegisterClassObject function to register the new class factory object as the class factory for the requested CLSID.
This class factory's implementation of the IClassFactory::CreateInstance method will create an instance of the requested CLSID method by calling the CoGetClassObject function to get the class factory which creates an actual object for the given CLSID.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Objidl.idl, Objidl.idl.
Link Library: Ole32.lib, Uuid.lib.
See Also
CoGetClassObject | CoRegisterClassObject | CoRegisterSurrogate | IClassFactory | IMarshal | ISurrogate | IUnknown | ISurrogate::FreeSurrogate
Send Feedback on this topic to the authors