CHANNEL_INIT_EVENT_FN回呼函式 (cchannel.h)

遠端桌面服務呼叫的應用程式定義回呼函式，以通知用戶端 DLL 的虛擬通道事件。

PCHANNEL_INIT_EVENT_FN類型會定義這個回呼函式的指標。 VirtualChannelInitEvent 是應用程式定義或連結庫定義函數名稱的佔位符。

語法

CHANNEL_INIT_EVENT_FN ChannelInitEventFn;

VOID VCAPITYPE ChannelInitEventFn(
  [in] LPVOID pInitHandle,
  [in] UINT event,
  [in] LPVOID pData,
  [in] UINT dataLength
)
{...}

參數

[in] pInitHandle

用戶端連線的句柄。 這是 VirtualChannelInit 函式的 ppInitHandle 參數中所傳回的句柄。

[in] event

指出造成通知的事件。 此參數可以是下列其中一個值。

CHANNEL_EVENT_INITIALIZED (0)

遠端桌面連線 (RDC) 用戶端初始化已完成。 pData 參數為 NULL。

CHANNEL_EVENT_CONNECTED (1)

已使用支持虛擬通道的 RD 工作階段主機伺服器建立連線。 pData 參數是具有伺服器名稱之 Null 終止字串的指標。

CHANNEL_EVENT_V1_CONNECTED (2)

已與不支持虛擬通道的 RD 工作階段主機伺服器建立連線。 pData 參數為 NULL。

CHANNEL_EVENT_DISCONNECTED (3)

RD 會話主機伺服器的連線已中斷連線。 pData 參數為 NULL。

CHANNEL_EVENT_TERMINATED (4)

用戶端已終止。 pData 參數為 NULL。

CHANNEL_EVENT_REMOTE_CONTROL_START (5)

遠端控制作業已啟動。 pData 參數為 NULL。

CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)

遠端控制作業已終止。 pData 參數是包含伺服器名稱之 Null 終止字串的指標。

[in] pData

事件之其他數據的指標。 數據類型取決於事件，如先前在事件描述中所述。

[in] dataLength

指定 pData 緩衝區中數據的大小，以位元組為單位。

傳回值

此函式不會傳回值。

備註

用戶端 DLL 會使用 VirtualChannelInit 函式向遠端桌面服務註冊其 VirtualChannelInitEvent 函式。

此函式會根據每個句柄重新進入。 函式在執行時可能會呼叫，但不在同一個句柄上多次呼叫。

只有在 VirtualChannelEntry 完成之後，才會呼叫此函式。

如果 連線傳送至另一個會話，則不會傳送CHANNEL_EVENT_CONNECTED和 CHANNEL_EVENT_DISCONNECTED 事件通知。 不過，管理連線所傳送之會話的伺服器端外掛程式將會收到重新連線通知。 Tscon.exe 之類的伺服器端工具可用來傳輸連線。 如需重新連線通知的詳細資訊，請參閱監視會話 Connections 和中斷連線。

例如，如果使用者模式外掛程式必須收到已重新連線 (的通知，例如，如果必須重設其狀態) ，伺服器端外掛程式應該將通知訊息傳送給用戶端。 此通知應該使用外掛程式用來彼此通訊的通訊協定。

規格需求

另請參閱

VirtualChannelInit