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