IWRdsProtocolConnectionCallback interface (wtsprotocol.h)

Exposes methods that provide information about the status of a client connection and that perform actions for the client. This interface is implemented by the Remote Desktop Services service and called by the protocol.

An instance of this interface is associated with a specific instance of the IWRdsProtocolConnection interface. When the following documentation refers to a connection, it is therefore referring to the specific connection for which the IWRdsProtocolConnection object was created.

Inheritance

The IWRdsProtocolConnectionCallback interface inherits from the IUnknown interface. IWRdsProtocolConnectionCallback also has these types of members:

Methods

The IWRdsProtocolConnectionCallback interface has these methods.

 
IWRdsProtocolConnectionCallback::BrokenConnection

Informs the Remote Desktop Services service that the client connection has been lost.
IWRdsProtocolConnectionCallback::GetConnectionId

Retrieves the connection identifier.
IWRdsProtocolConnectionCallback::OnReady

Requests that the Remote Desktop Services service continue the connection process for that client.
IWRdsProtocolConnectionCallback::RedrawWindow

Requests that the Remote Desktop Services service redraw the client window.
IWRdsProtocolConnectionCallback::StopScreenUpdates

Requests that the Remote Desktop Services service stop updating the client screen.

Remarks

To avoid a possible deadlock when calling any of the methods on this interface, you should not make any function or method calls that will directly or indirectly result in a Remote Desktop Services API being called. If you need to make any outbound call, you should start a new thread and make the outbound call from the new thread.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2012
Target Platform Windows
Header wtsprotocol.h