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

Weitere Informationen

IWTSProtocolShadowCallback