WTSConnectSessionA, fonction (wtsapi32.h)

Article
11/20/2024

Connecte une session 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 d’ouverture de session 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 est routée vers la session identifiée par le paramètre TargetLogonId .

Il peut s’agir LOGONID_CURRENT d’utiliser la session active.

[in] TargetLogonId

ID d’ouverture de session 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.

Il peut s’agir 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 d’ouverture de session. La valeur de pPassword ne peut pas être NULL.

[in] bWait

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

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

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

Note

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