Fonction WTSConnectSessionA (wtsapi32.h)

Article
08/28/2023

Connecte une session des services Bureau à distance à une session existante sur l’ordinateur local.

Syntaxe

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

Paramètres

[in] LogonId

ID de connexion de la session à laquelle se connecter. L’utilisateur de cette session doit disposer des autorisations nécessaires pour se connecter à une session existante. La sortie de cette session sera routée vers la session identifiée par le paramètre TargetLogonId .

Cela peut être LOGONID_CURRENT d’utiliser la session active.

[in] TargetLogonId

ID de connexion de la session à recevoir la sortie de la session représentée par le paramètre LogonId . La sortie de la session identifiée par le paramètre LogonId sera routée vers cette session.

Cela peut être LOGONID_CURRENT d’utiliser la session active.

[in] pPassword

Pointeur vers le mot de passe du compte d’utilisateur spécifié dans le paramètre LogonId . La valeur de pPassword peut être une chaîne vide si l’appelant est connecté à l’aide du même nom de domaine et du même nom d’utilisateur que l’ID de connexion. La valeur de pPassword ne peut pas être NULL.

[in] bWait

Indique si l’opération est synchrone. Spécifiez TRUE pour attendre la fin de l’opération ou FALSE pour retourner immédiatement.

Valeur retournée

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étaillées sur l’erreur, appelez GetLastError.

Remarques

Le paramètre LogonId ou TargetLogonId peut être LOGONID_CURRENT, mais pas les deux.

Notes

L’en-tête wtsapi32.h définit WTSConnectSession comme un 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.

Spécifications


Client minimal pris en charge	Windows Vista avec SP1
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wtsapi32.h
Bibliothèque	Wtsapi32.lib
DLL	Wtsapi32.dll

Partager via