IWTSProtocolConnectionCallback::RedrawWindow method

[IWTSProtocolConnectionCallback::RedrawWindow is no longer available for use as of Windows Server 2012. Instead, use IWRdsProtocolConnectionCallback::RedrawWindow.]

Requests that the Remote Desktop Services service redraw the client window.

Syntax


HRESULT RedrawWindow(
  [in, optional] WTS_SMALL_RECT *rect
);

Parameters

rect [in, optional]

A WTS_SMALL_RECT structure that contains the x and y coordinates of the screen to redraw. A value of NULL requests that the entire screen be redrawn.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following list. For a list of common error codes, see Common HRESULT Values.

HRESULT_FROM_WIN32(ERROR_NOT_CONNECTED)

The client is not connected.

Remarks

This method is typically called after the StopScreenUpdates method.

To avoid deadlocks when calling this method:

  • Create a separate thread on which to make the call. Do not make the call from inside of any protocol method that you are implementing.
  • Do not block on this method before replying to another call by the Remote Desktop Services service.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2

End of server support

Windows Server 2008 R2

Header

Wtsprotocol.h

IDL

Wtsprotocol.idl

See also

IWTSProtocolConnectionCallback
StopScreenUpdates

 

 

Show: