共用方式為


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)

另請參閱

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose