Fonction WTSVirtualChannelOpen (wtsapi32.h)

Ouvre un handle à l’extrémité du serveur d’un canal virtuel spécifié.

Cette fonction est obsolète. Utilisez plutôt la fonction WTSVirtualChannelOpenEx .

Syntaxe

HANDLE WTSVirtualChannelOpen(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] LPSTR  pVirtualName
);

Paramètres

[in] hServer

Ce paramètre doit être WTS_CURRENT_SERVER_HANDLE.

[in] SessionId

Identificateur de session des services Bureau à distance. Pour indiquer la session active, spécifiez WTS_CURRENT_SESSION. Vous pouvez utiliser la fonction WTSEnumerateSessions pour récupérer les identificateurs de toutes les sessions sur un serveur hôte de session Bureau à distance spécifié.

Pour ouvrir un canal virtuel sur la session d’un autre utilisateur, vous devez disposer de l’autorisation du canal virtuel. Pour plus d’informations, consultez Autorisations des services Bureau à distance. Pour modifier les autorisations sur une session, utilisez l’outil d’administration Configuration des services Bureau à distance.

[in] pVirtualName

Pointeur vers une chaîne terminée par null contenant le nom du canal virtuel. Notez qu’il s’agit d’une chaîne ANSI même quand UNICODE est défini. Le nom du canal virtuel se compose d’un à CHANNEL_NAME_LEN caractères, sans compter la valeur null de fin.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle du canal virtuel spécifié.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une fois que vous avez terminé d’utiliser le handle, relâchez-le en appelant la fonction WTSVirtualChannelClose .

Pour obtenir un exemple qui montre comment accéder à un handle de fichier de canal virtuel qui peut être utilisé pour les E/S asynchrones, consultez WTSVirtualChannelQuery.

Si vous essayez d’utiliser cette fonction pour ouvrir le même canal virtuel plusieurs fois, cela peut entraîner un délai de 10 secondes et perturber le canal établi.

Configuration requise

Voir aussi

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose