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

[アーティクル]
08/22/2023

リモートデスクトップサービスが仮想チャネルイベントをクライアント 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と切断の監視」を参照してください。

ユーザーモードプラグインが再接続されたことを通知する必要がある場合 (たとえば、その状態をリセットする必要がある場合)、サーバー側プラグインはクライアントに通知メッセージを送信する必要があります。この通知では、プラグインが相互に通信するために使用するプロトコルを使用する必要があります。

要件

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

こちらもご覧ください

VirtualChannelInit

次の方法で共有