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

ITsSbResourceNotification

COM
📘 Microsoft Learn (日本語) · English
IID65d3e85a-c39b-11dc-b92d-3cd255d89593継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

リモート デスクトップ接続ブローカー (RD 接続ブローカー) が、セッション、ターゲット、クライアント接続の各オブジェクトで発生した状態変化をプラグインに通知するために使用するメソッドを公開します。(ITsSbResourceNotification)

メソッド 3

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT NotifySessionChange(TSSESSION_STATE changeType, ITsSbSession* pSession)

セッションオブジェクトの状態変化について、登録済みのプラグインに通知します。(ITsSbResourceNotification.NotifySessionChange)

changeTypeTSSESSION_STATEin発生した変化の種類。
pSessionITsSbSession*inセッションオブジェクトへのポインター。このオブジェクトは、RD 接続ブローカーのストアに存在するオブジェクトのコピーです。このオブジェクトに加えた変更は、ストア内のオブジェクトには影響しません。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

RD 接続ブローカーは、セッションオブジェクトの状態変化について登録済みのプラグインに通知するために NotifySessionChange メソッドを呼び出します。たとえば、セッションのログオンの結果として新しいセッションがリソースプラグインのストアに追加されたときに、RD 接続ブローカーはこのメソッドを呼び出します。

vtbl 4 HRESULT NotifyTargetChange(DWORD TargetChangeType, ITsSbTarget* pTarget)

ターゲットオブジェクトの状態変化について、登録済みのプラグインに通知します。(ITsSbResourceNotification.NotifyTargetChange)

TargetChangeTypeDWORDinターゲットで発生した変化の種類を指定する TARGET_CHANGE_TYPE 列挙型の値。
pTargetITsSbTarget*inターゲットオブジェクトへのポインター。このオブジェクトは、RD 接続ブローカーのストアに存在するオブジェクトのコピーです。このオブジェクトに加えた変更は、ストア内のオブジェクトには影響しません。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

RD 接続ブローカーは、ターゲットオブジェクトの状態変化について登録済みのプラグインに通知するために NotifyTargetChange メソッドを呼び出します。たとえば、セッションのログオンの結果として新しいセッションがリソースプラグインのストアに追加されたときに、RD 接続ブローカーはこのメソッドを呼び出します。

vtbl 5 HRESULT NotifyClientConnectionStateChange(CONNECTION_CHANGE_NOTIFICATION ChangeType, ITsSbClientConnection* pConnection)

クライアント接続の状態変化について、登録済みのプラグインに通知します。(ITsSbResourceNotification.NotifyClientConnectionStateChange)

ChangeTypeCONNECTION_CHANGE_NOTIFICATIONin

発生した変化の種類。このパラメーターには、次のいずれかの値を指定できます。

CONNECTION_REQUEST_PENDING

クライアントの要求が、ユーザーからのセッションログオンを待機しています。

CONNECTION_REQUEST_FAILED

RD 接続ブローカーが要求の処理に失敗しました。この値は、RD 接続ブローカーがストアから接続要求を削除する直前に発行されます。

CONNECTION_REQUEST_TIMEDOUT

要求がタイムアウトしました。これは通常、ユーザーが要求をキャンセルしたか、ネットワーク接続の問題によりログオンできなかったことを意味します。この値は、RD 接続ブローカーがストアから接続要求を削除する直前に発行されます。

CONNECTION_REQUEST_SUCCEEDED

ユーザーがターゲットコンピューターへのログオンに成功しました。この値は、RD 接続ブローカーがストアから接続要求を削除する直前に発行されます。

CONNECTION_REQUEST_CANCELLED

RD 接続ブローカーのサービスの停止中に接続要求が処理されていたため、RD 接続ブローカーが接続要求をキャンセルしました。

pConnectionITsSbClientConnection*inITsSbClientConnection 接続オブジェクトへのポインター。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

RD 接続ブローカーは、クライアント接続の状態変化について登録済みのプラグインに通知するために NotifyClientConnectionStateChange メソッドを呼び出します。

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

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_ITsSbResourceNotification "{65D3E85A-C39B-11DC-B92D-3CD255D89593}"
#usecom global ITsSbResourceNotification IID_ITsSbResourceNotification "{}"
#comfunc global ITsSbResourceNotification_NotifySessionChange                3 int,sptr
#comfunc global ITsSbResourceNotification_NotifyTargetChange                 4 int,sptr
#comfunc global ITsSbResourceNotification_NotifyClientConnectionStateChange  5 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。