Win32 API 日本語リファレンス
ホーム › System.RemoteDesktop › PVIRTUALCHANNELOPEN

PVIRTUALCHANNELOPEN

コールバック

シグネチャ

DWORD PVIRTUALCHANNELOPEN(
    void* pInitHandle,
    DWORD* pOpenHandle,
    LPSTR pChannelName,
    PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
);

パラメーター

フィールド型説明
pInitHandlevoid*クライアント接続へのハンドル。これは VirtualChannelInit 関数の ppInitHandle パラメーターで返されたハンドルです。
pOpenHandleDWORD*変数へのポインター。この変数は、以降の VirtualChannelWrite 関数および VirtualChannelClose 関数の呼び出しで、開かれた仮想チャネルを識別するハンドルを受け取ります。
pChannelNameLPSTR開く仮想チャネルの名前を格納した、null で終わる ANSI 文字列へのポインター。この名前は、クライアントが VirtualChannelInit 関数を呼び出したときに登録されている必要があります。
pChannelOpenEventProcPCHANNEL_OPEN_EVENT_FNアプリケーション定義の VirtualChannelOpenEvent 関数へのポインター。リモート デスクトップ サービスは、この仮想チャネルに関するイベントをクライアント DLL に通知するために、この関数を呼び出します。

公式ドキュメント

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

リモート デスクトップ サービスは、 VirtualChannelEntry エントリ ポイントに渡される CHANNEL_ENTRY_POINTS 構造体に、 VirtualChannelOpen 関数へのポインターを提供します。

戻り値

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

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)