WTSStartRemoteControlSessionW, fonction (wtsapi32.h)

Article
11/20/2024

Démarre le contrôle à distance d’une autre session services Bureau à distance. Vous devez appeler cette fonction à partir d’une session distante.

Syntaxe

BOOL WTSStartRemoteControlSessionW(
  [in] LPWSTR pTargetServerName,
  [in] ULONG  TargetLogonId,
  [in] BYTE   HotkeyVk,
  [in] USHORT HotkeyModifiers
);

Paramètres

[in] pTargetServerName

Pointeur vers le nom du serveur où la session à laquelle vous souhaitez contrôler à distance existe.

[in] TargetLogonId

ID d’ouverture de session de la session dont vous souhaitez contrôler à distance.

[in] HotkeyVk

Code de clé virtuelle qui représente la touche à appuyer pour arrêter le contrôle à distance de la session. La clé définie dans ce paramètre est utilisée avec le paramètre HotkeyModifiers.

[in] HotkeyModifiers

Modificateur virtuel qui représente la touche à appuyer pour arrêter le contrôle à distance de la session. Le modificateur virtuel est utilisé avec le paramètre HotkeyVk.

Par exemple, si la fonction WTSStartRemoteControlSession est appelée avec HotkeyVk définie sur VK_MULTIPLY et HotkeyModifiers définie sur REMOTECONTROL_KBDCTRL_HOTKEY, l’utilisateur disposant d’un contrôle à distance de la session cible peut appuyer sur Ctrl + * pour arrêter le contrôle à distance de la session et revenir à sa propre session.

REMOTECONTROL_KBDSHIFT_HOTKEY

Touche Maj

REMOTECONTROL_KBDCTRL_HOTKEY

Touche Ctrl

REMOTECONTROL_KBDALT_HOTKEY

Touche ALT

Valeur de retour

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Note

L’en-tête wtsapi32.h définit WTSStartRemoteControlSession comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista avec SP1
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	wtsapi32.h
bibliothèque	Wtsapi32.lib
DLL	Wtsapi32.dll

Partager via