IWTSProtocolConnectionCallback::RedrawWindow-Methode (wtsprotocol.h)
[IWTSProtocolConnectionCallback::RedrawWindow ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnectionCallback::RedrawWindow.]
Fordert an, dass der Remotedesktopdienstedienst das Clientfenster neu zeichnet.
Syntax
HRESULT RedrawWindow(
[in, optional] WTS_SMALL_RECT *rect
);
Parameter
[in, optional] rect
Eine WTS_SMALL_RECT Struktur, die die x- und y-Koordinaten des zu gezeichneten Bildschirms enthält. Der Wert NULL fordert an, dass der gesamte Bildschirm neu gezeichnet wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind u. a. die werte in der folgenden Liste. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Diese Methode wird in der Regel nach der StopScreenUpdates-Methode aufgerufen.
So vermeiden Sie Deadlocks beim Aufrufen dieser Methode:
- Erstellen Sie einen separaten Thread, für den der Aufruf ausgeführt werden soll. Führen Sie den Aufruf nicht von innerhalb einer Protokollmethode aus, die Sie implementieren.
- Blockieren Sie diese Methode nicht, bevor Sie auf einen anderen Aufruf des Remotedesktopdiensts antworten.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | wtsprotocol.h |