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通知。

規格需求

另請參閱

VirtualChannelClose

VirtualChannelInit

VirtualChannelInitEvent

VirtualChannelOpenEvent

VirtualChannelWrite