COM
Expand Minimize

CoResumeClassObjects function

Called by a server that can register multiple class objects to inform the SCM about all registered classes, and permits activation requests for those class objects.

Syntax


HRESULT CoResumeClassObjects(void);

Parameters

This function has no parameters.

Return value

This function returns S_OK to indicate that the CLSID was retrieved successfully.

Remarks

Servers that can register multiple class objects call CoResumeClassObjects once, after having first called CoRegisterClassObject, specifying REGCLS_LOCAL_SERVER | REGCLS_SUSPENDED for each CLSID the server supports. This function causes OLE to inform the SCM about all the registered classes, and begins letting activation requests into the server process.

This reduces the overall registration time, and thus the server application startup time, by making a single call to the SCM, no matter how many CLSIDs are registered for the server. Another advantage is that if the server has multiple apartments with different CLSIDs registered in different apartments, or is a free-threaded server, no activation requests will come in until the server calls CoResumeClassObjects. This gives the server a chance to register all of its CLSIDs and get properly set up before having to deal with activation requests, and possibly shutdown requests.

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Objbase.h

Library

Ole32.lib

DLL

Ole32.dll

See also

CoRegisterClassObject
CoSuspendClassObjects
Out-of-Process Server Implementation Helpers

 

 

Community Additions

ADD
Show:
© 2014 Microsoft