virtualCHANNELOPEN 回呼函式 (cchannel.h)
開啟虛擬通道的用戶端結尾。
遠端桌面服務會在傳遞至 VirtualChannelEntry 進入點的 CHANNEL_ENTRY_POINTS 結構中，提供 VirtualChannelOpen 函式的指標。
語法
VIRTUALCHANNELOPEN Virtualchannelopen;
UINT VCAPITYPE Virtualchannelopen(
[in] LPVOID pInitHandle,
[out] LPDWORD pOpenHandle,
[in] PCHAR pChannelName,
[in] PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}
參數
[in] pInitHandle
用戶端連線的句柄。 這是 VirtualChannelInit 函式之 ppInitHandle 參數中傳回的句柄。
[out] pOpenHandle
接收句柄的變數指標，該句柄會在後續呼叫 VirtualChannelWrite 和 VirtualChannelClose 函式時識別開啟的虛擬通道。
[in] pChannelName
以 Null 結尾的 ANSI 字元字串指標，其中包含要開啟之虛擬通道的名稱。 當用戶端呼叫 VirtualChannelInit 函式時，必須註冊名稱。
[in] pChannelOpenEventProc
遠端桌面服務呼叫的應用程式定義 VirtualChannelOpenEvent 函式指標，以通知用戶端 DLL 此虛擬通道的事件。
傳回值
如果函式成功，傳回值會CHANNEL_RC_OK。
如果發生錯誤，函式會傳回下列其中一個值。
備註
用戶端 DLL 在用戶端與 RD 工作階段主機伺服器建立連線之前，無法呼叫此函式。 建立 RD 作業階段主機伺服器連線時， VirtualChannelInitEvent 函式會收到CHANNEL_EVENT_CONNECTED通知。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | cchannel.h |