VIRTUALCHANNELOPEN コールバック関数 (cchannel.h)

[アーティクル]
02/23/2024

仮想チャネルのクライアント側を開きます。

リモートデスクトップサービスは、 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

リモートデスクトップサービスがこの仮想チャネルのイベントをクライアント DLL に通知するために呼び出す、アプリケーション定義の VirtualChannelOpenEvent 関数へのポインター。

戻り値

関数が成功した場合、戻り値はCHANNEL_RC_OK。

エラーが発生した場合、関数は次のいずれかの値を返します。

注釈

クライアント DLL は、クライアントが RD セッションホストサーバーとの接続を確立するまで、この関数を呼び出すことができません。 VirtualChannelInitEvent 関数は、RD セッションホストサーバー接続が確立されると、CHANNEL_EVENT_CONNECTED通知を受け取ります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	cchannel.h