IDeviceAgentTransport::RegisterShutdownCallback
更新 : 2007 年 11 月
エージェントがシャットダウンされる前に通知を受け取るためのコールバックを登録します。
HRESULT RegisterShutdownCallback([in] IAgentTransportShutdownCallback *in_pCallback, [in] IUnknown *in_pUnknown)
パラメータ
in_pCallback
シャットダウン通知を受け取るオブジェクト。このオブジェクトは IAgentTransportShutdownCallback を実装する必要があります。in_pUnknown
コールバック ルーチンにパラメータとして渡されるインターフェイス Cookie。
戻り値
メソッド呼び出しの結果を示す HRESULT 値。
解説
エージェントは、デスクトップが明示的にシャットダウンされるか、clientshutdown.exe の実行によって conmanclient2.exe がシャットダウンされたときにシャットダウンされます。デバイス エージェントは、クリーンアップを実行して正常に終了するために、シャットダウン通知を受信するよう要求できます。デバイス エージェントがシャットダウン通知を受信するためには、IAgentTransportShutdownCallback を実装するクラスを定義し、このメソッドを使用して登録する必要があります。
使用例
デバイス エージェントにカスタム シャットダウン コールバック オブジェクトを登録する例を次に示します。コード例全体については、「IDeviceAgentTransport」を参照してください。
// Register the callback with the Device Agent Transport
MyShutdownCallback *shutdownCallback = new MyShutdownCallback();
pTransport->RegisterShutdownCallback(shutdownCallback,shutdownCallback);
相当するマネージ機能
IDeviceAgentTransport.RegisterShutdownCallback
必要条件
DeviceAgentTransport.h