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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | wtsapi32.h |
| Bibliothèque | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| Ensemble d’API | ext-ms-win-session-wtsapi32-l1-1-0 (introduit dans Windows 8) |