WTSVirtualChannelOpen 函式 (wtsapi32.h)
開啟指定之虛擬通道之伺服器端的句柄。
此函式已過時。 請改用 WTSVirtualChannelOpenEx 函式。
語法
HANDLE WTSVirtualChannelOpen(
[in] HANDLE hServer,
[in] DWORD SessionId,
[in] LPSTR pVirtualName
);
參數
[in] hServer
此參數必須WTS_CURRENT_SERVER_HANDLE。
[in] SessionId
遠端桌面服務會話標識碼。 若要指出目前的工作階段，請指定 WTS_CURRENT_SESSION。 您可以使用 WTSEnumerateSessions 函式來擷取指定 RD 工作階段主機伺服器上所有工作階段的識別碼。
若要在另一位使用者的會話上開啟虛擬通道，您必須擁有來自虛擬通道的許可權。 如需詳細資訊，請參閱 遠端桌面服務許可權。 若要修改會話的許可權，請使用遠端桌面服務組態系統管理工具。
[in] pVirtualName
包含虛擬通道名稱之 Null 終止字串的指標。 請注意，即使已定義 UNICODE，這是 ANSI 字串。 虛擬通道名稱包含一到CHANNEL_NAME_LEN字元，不包括終止 Null。
傳回值
如果函式成功，則傳回值是指定之虛擬通道的句柄。
如果函式失敗，則傳回值為 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
當您完成使用句柄時，請呼叫 WTSVirtualChannelClose 函式來釋放它。
如需示範如何存取可用於異步 I/O 之虛擬通道檔案句柄的範例，請參閱 WTSVirtualChannelQuery。
如果您嘗試使用此函式多次開啟相同的虛擬通道，可能會導致 10 秒延遲並中斷已建立的通道。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | wtsapi32.h |
| 程式庫 | Wtsapi32.lib |
| Dll | Wtsapi32.dll |
| API 集合 | ext-ms-win-session-wtsapi32-l1-1-0 (於 Windows 8) |