IWTSProtocolShadowConnection::Start method (wtsprotocol.h)

[IWTSProtocolShadowConnection::Start is no longer available for use as of Windows Server 2012. Instead, use IWRdsProtocolShadowConnection::Start.]

Notifies the protocol that shadowing has started.

Syntax

HRESULT Start(
  [in] WCHAR                      *pTargetServerName,
  [in] DWORD                      TargetSessionId,
  [in] BYTE                       HotKeyVk,
  [in] USHORT                     HotkeyModifiers,
  [in] IWTSProtocolShadowCallback *pShadowCallback
);

Parameters

[in] pTargetServerName

A pointer to a string that contains the name of the shadowing server.

[in] TargetSessionId

An integer that specifies the ID of the target session to shadow.

[in] HotKeyVk

The virtual key code of the key that must be pressed to stop shadowing. This key is used in combination with the HotkeyModifiers parameter.

[in] HotkeyModifiers

The virtual modifier that specifies the modifier key to press to stop shadowing. Modifier keys include the Shift, Alt, and Ctrl keys. The modifier key is used in combination with the key signified by the HotKeyVk parameter.

[in] pShadowCallback

A pointer to an IWTSProtocolShadowCallback interface that the protocol can use to call back into the Remote Desktop Services service.

Return value

When you are implementing this method, return S_OK if the function succeeds. If it fails, return an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

The Remote Desktop Services service also changes the session state on the shadowed client to reflect the fact that it is being shadowed.

Requirements

See also

IWTSProtocolShadowConnection