CONNECT Sample: Demonstrates Implementation and Use of Connection Points (C++ Samples)
This sample illustrates the use and implementation of connection points (the IConnectionPointContainer and IConnectionPoint interfaces) in a multithreaded environment.
Note
This sample is a modification of the ATL sample Connect to demonstrate compiler COM support for connection point sinks. The Drive client is a native implementation, whereas the MDrive client slightly belabors COM-correctness in using a class factory to create sink objects. Neither Drive nor MDrive depend on ATL or MFC for any COM support.
.gif "Security note") Security Note |
|---|
This sample code is intended to illustrate a concept, and it shows only the code that is relevant to that concept. It may not meet the security requirements for a specific environment, and it should not be used exactly as shown. We recommend that you add security and error-handling code to make your projects more secure and robust. Microsoft provides this sample code "AS IS" with no warranties. |
To get samples and instructions for installing them:
To access samples from Visual Studio
On the Help menu, click Samples.
By default, these samples are installed in drive:\Program Files\Microsoft Visual Studio 10.0\Samples\.
- For the most recent version of this sample and a list of other samples, see Visual Studio Samples on the MSDN Web site.
Building and Running the Sample
To build and run this sample
Open the solution connect.sln.
On the Build menu, click Build Solution.
Select which client you want to run, Drive or MDrive, and make it the startup project (right-click the project folder and click Set as StartUp Project). More information about the clients can be found in the How the Sample Works section.
On the Debug menu, click Start Without Debugging.
How the Sample Works
The server is implemented in Connect.dll. This DLL allows the creation of a CoRandom COM object, implemented by the CRandom C++ class. The COM object supports IRandom (a dual interface) and IConnectionPointContainer, and it accepts connections for the IRandomEvent interface.
The IRandom interface supports the following methods.
Start Starts a thread inside the object.
Stop Stops a thread inside the object.
StopAll Stops all running threads.
When running, the secondary threads inside the object keep firing events through the connection point.
Two clients are provided: Drive and MDrive. They can be found in the Drive and MDrive subdirectories.
Drive.exe is a simple console application that provides a single object implementing the IRandomEvent interface. It creates a CoRandom object, calls Advise and Unadvise on the connection point, and has the CoRandom object fire events into the drive's object.
Mdrive.exe is an MFC dialog-based application, able to create multiple advise sinks and to control the number of threads the server creates. When you run Mdrive.exe, click the Start button at least once, then click the Advise button several times. Each click of the Advise button adds a connection point, which makes the display wider. If you do not click the Advise button, you will not see any activity in the display.