IWTSProtocolShadowCallback::InvokeTargetShadow-Methode (wtsprotocol.h)
[IWTSProtocolShadowCallback::InvokeTargetShadow ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolShadowCallback::InvokeTargetShadow.]
Weist den Remotedesktopdienste-Dienst an, die Zielseite des Schattens zu starten, und übergibt alle Informationen, die zwischen dem Client und dem Ziel ausgetauscht werden müssen.
Syntax
HRESULT InvokeTargetShadow(
[in] WCHAR *pTargetServerName,
[in] ULONG TargetSessionId,
[in] PBYTE pParam1,
[in] DWORD Param1Size,
[in] PBYTE pParam2,
[in] DWORD Param2Size,
[in] PBYTE pParam3,
[in] DWORD Param3Size,
[in] PBYTE pParam4,
[in] DWORD Param4Size,
[in] WCHAR *pClientName
);
Parameter
[in] pTargetServerName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Schattenzielservers enthält.
[in] TargetSessionId
Eine ganze Zahl, die die ID der Zielsitzung angibt, die überschatten soll.
[in] pParam1
Ein Zeiger auf ein Byte, das einen beliebigen Parameter enthält.
[in] Param1Size
Eine ganze Zahl, die die Größe des Werts in Bytes enthält, auf den der pParam1-Parameter verweist.
[in] pParam2
Ein Zeiger auf ein Byte, das einen beliebigen Parameter enthält.
[in] Param2Size
Eine ganze Zahl, die die Größe des Werts in Bytes enthält, auf den der pParam2-Parameter verweist.
[in] pParam3
Ein Zeiger auf ein Byte, das einen beliebigen Parameter enthält.
[in] Param3Size
Eine ganze Zahl, die die Größe des Werts in Bytes enthält, auf den der pParam3-Parameter verweist.
[in] pParam4
Ein Zeiger auf ein Byte, das einen beliebigen Parameter enthält.
[in] Param4Size
Eine ganze Zahl, die die Größe des Werts in Bytes enthält, auf den der pParam4-Parameter verweist.
[in] pClientName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Schattenclients enthält.
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
Die vier Parameter pParam1, pParam2, pParam3 und pParam4 können alle Informationen enthalten, die zwischen dem Schattenclient und dem Schattenziel ausgetauscht werden müssen. Der Remotedesktopdienstedienst übergibt die Informationen ohne Änderung.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | wtsprotocol.h |