Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Interacts with the remote desktop viewer control to enable Windows Desktop Sharing scenarios.
This class implements the following interfaces.
- IRDPSRAPIViewer interface
- _IRDPSessionEvents interface
- IRDPSRAPIDebug interface
- IOleObject interface
- IOleInPlaceActiveObject interface
- IOleInPlaceObject interface interface
- IConnectionPointContainer interface
A pointer to each of these interfaces can be obtained by calling IUnknown::QueryInterface
Remarks
To initialize an instance of RDPViewer, call CoCreateInstance, specifying CLSID_RDPViewer for the rclsid parameter and CLSCTX_INPROC_SERVER for the dwClsContext parameter.
The following list describes example uses of the RDPViewer class for Windows Desktop Sharing scenarios.
- Configure the viewer control's display location by calling IOleObject::SetClientSite.
- Display the viewer control by calling IOleObject::DoVerb and specifying OLEIVERB_PRIMARY for the iVerb parameter.
- Connect the viewer control by calling IRDPSRAPIViewer::Connect.
- Get the HWND of the viewer control by calling GetWindow on a pointer to its IOleInPlaceActiveObject interface.
- Notify the viewer control of the activation of the application window by calling IOleInPlaceActiveObject::OnFrameWindowActivate
- Receive the notifications for _IRDPSessionEvents events from the viewer control by calling IConnectionPointContainer::FindConnectionPoint, specifying
__uuidof(_IRDPSessionEvents)for the riid parameter, and then calling IConnectionPoint::Advise with an application-defined implementation of _IRDPSessionEvents. The application is responsible for implementing the dispatching of those events to its _IRDPSessionEvents interface from its implementation of IDispatch::Invoke.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 10 [desktop apps only] |
| Minimum supported server |
Windows Server 2016 |
| Type library |
|
| DLL |
|
| CLSID |
CLSID_RdpViewer is defined as 32be5ed2-5c86-480f-a914-0ff8885a1b3f |