次の方法で共有

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

参照

参照

IDeviceAgentTransport