UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | req.apiset | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:wtsapi32.WTSVirtualChannelOpen |
WTSVirtualChannelOpen function (wtsapi32.h) |
Opens a handle to the server end of a specified virtual channel. |
|
termserv\wtsvirtualchannelopen.htm |
TermServ |
0daaf06f-ba05-469c-b888-3df5d9495364 |
12/05/2018 |
WTSVirtualChannelOpen, WTSVirtualChannelOpen function [Remote Desktop Services], _win32_wtsvirtualchannelopen, termserv.wtsvirtualchannelopen, wtsapi32/WTSVirtualChannelOpen |
wtsapi32.h |
Windows |
Windows Vista |
Windows Server 2008 |
Wtsapi32.lib |
Wtsapi32.dll |
Windows |
19H1 |
|
|
|
|
|
|
ext-ms-win-session-wtsapi32-l1-1-0 (introduced in Windows 8) |
Opens a handle to the server end of a specified virtual channel.
This function is obsolete. Instead, use the WTSVirtualChannelOpenEx function.
This parameter must be WTS_CURRENT_SERVER_HANDLE.
A Remote Desktop Services session identifier. To indicate the current session, specify WTS_CURRENT_SESSION. You can use the WTSEnumerateSessions function to retrieve the identifiers of all sessions on a specified RD Session Host server.
To open a virtual channel on another user's session, you need to have permission from the Virtual Channel. For more information, see Remote Desktop Services Permissions. To modify permissions on a session, use the Remote Desktop Services Configuration administrative tool.
A pointer to a null-terminated string containing the virtual channel name. Note that this is an ANSI string even when UNICODE is defined. The virtual channel name consists of one to CHANNEL_NAME_LEN characters, not including the terminating null.
If the function succeeds, the return value is a handle to the specified virtual channel.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
When you have finished using the handle, release it by calling the WTSVirtualChannelClose function.
For an example that shows how to gain access to a virtual channel file handle that can be used for asynchronous I/O, see WTSVirtualChannelQuery.
If you try to use this function to open the same virtual channel multiple times, it can cause a 10-second delay and disrupt the established channel.