Funzione WTSStartRemoteControlSessionA (wtsapi32.h)

Avvia il controllo remoto di un'altra sessione di Servizi Desktop remoto. È necessario chiamare questa funzione da una sessione remota.

Sintassi

BOOL WTSStartRemoteControlSessionA(
  [in] LPSTR  pTargetServerName,
  [in] ULONG  TargetLogonId,
  [in] BYTE   HotkeyVk,
  [in] USHORT HotkeyModifiers
);

Parametri

[in] pTargetServerName

Puntatore al nome del server in cui esiste la sessione di cui si vuole controllare remoto.

[in] TargetLogonId

ID di accesso della sessione di cui si vuole il controllo remoto.

[in] HotkeyVk

Codice chiave virtuale che rappresenta il tasto da premere per arrestare il controllo remoto della sessione. La chiave definita in questo parametro viene usata con il parametro HotkeyModifiers .

[in] HotkeyModifiers

Modificatore virtuale che rappresenta il tasto da premere per arrestare il controllo remoto della sessione. Il modificatore virtuale viene usato con il parametro HotkeyVk .

Ad esempio, se la funzione WTSStartRemoteControlSession viene chiamata con HotkeyVk impostata su VK_MULTIPLY e HotkeyModifiers impostata su REMOTECONTROL_KBDCTRL_HOTKEY, l'utente che ha il controllo remoto della sessione di destinazione può premere CTRL + * per arrestare il controllo remoto della sessione e tornare alla propria sessione.

REMOTECONTROL_KBDSHIFT_HOTKEY

Tasto MAIUSC

REMOTECONTROL_KBDCTRL_HOTKEY

Tasto CTRL

REMOTECONTROL_KBDALT_HOTKEY

Tasto ALT

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione wtsapi32.h definisce WTSStartRemoteControlSession come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll