Funzione WTSStartRemoteControlSessionA (wtsapi32.h)

Articolo
11/20/2024

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 desidera il controllo remoto.

[in] TargetLogonId

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

[in] HotkeyVk

Codice della 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista con SP1
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll

Condividi tramite