VIRTUALCHANNELINIT 回呼函式 (cchannel.h)

初始化用戶端 DLL 對遠端桌面服務虛擬通道的存取。 用戶端會呼叫 VirtualChannelInit 來註冊其虛擬通道的名稱。

遠端桌面服務會在傳遞至 VirtualChannelEntry 進入點的 CHANNEL_ENTRY_POINTS 結構中，提供 VirtualChannelInit 函式的指標。

語法

VIRTUALCHANNELINIT Virtualchannelinit;

UINT VCAPITYPE Virtualchannelinit(
  [in]      LPVOID *ppInitHandle,
  [in, out] PCHANNEL_DEF pChannel,
  [in]      INT channelCount,
  [in]      ULONG versionRequested,
  [in]      PCHANNEL_INIT_EVENT_FN pChannelInitEventProc
)
{...}

參數

[in] ppInitHandle

接收可識別客戶端連線之句柄的變數指標。 使用此句柄在 對 VirtualChannelOpen 函式的後續呼叫中識別用戶端。

[in, out] pChannel

CHANNEL_DEF 結構的陣列指標。 每個結構都包含用戶端 DLL 將開啟之虛擬通道的名稱和初始化選項。 請注意， VirtualChannelInit 呼叫不會開啟這些虛擬通道;它只會保留此應用程式使用的名稱。

[in] channelCount

指定 pChannel 陣列中的項目數目。

[in] versionRequested

指定虛擬通道支援層級。 將此參數設定為 VIRTUAL_CHANNEL_VERSION_WIN2000。

[in] pChannelInitEventProc

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

傳回值

如果函式成功，傳回值 會CHANNEL_RC_OK。

如果發生錯誤，函式會傳回下列其中一個值。

備註

您只能從 VirtualChannelEntry 函式呼叫 VirtualChannelInit 函式。 任何其他時間對 VirtualChannelInit 的呼叫都會失敗。

當 VirtualChannelInit 成功傳回時，遠端桌面服務已註冊要求的通道。 不過，遠端桌面服務可能尚未完成其他初始化。 當所有初始化完成時，遠端桌面服務會使用 CHANNEL_EVENT_INITIALIZED 事件呼叫 VirtualChannelInitEvent 回呼函式。

您不應該在呼叫此函式之前先假設可用的虛擬通道數目，因為系統和其他外掛程式可能會有保留的虛擬通道。 因此，呼叫此函式之後，您應該一律檢查 CHANNEL_RC_TOO_MANY_CHANNELS 傳回碼。

當 VirtualChannelInit 傳回時，如果通道已成功初始化，則每個CHANNEL_DEF結構的選項成員都會包含CHANNEL_OPTION_INITIALIZED。

每個客戶端會話的通道數目上限為 CHANNEL_MAX_COUNT。

規格需求

另請參閱

CHANNEL_DEF

VirtualChannelEntry

VirtualChannelInitEvent