IDeviceAgentTransport.RegisterShutdownCallback メソッド

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

更新 : 2007 年 11 月

エージェントがシャットダウンされる前に通知を受け取るコールバックを登録します。

名前空間 : Microsoft.SmartDevice.DeviceAgentTransport
アセンブリ : Microsoft.SmartDevice.DeviceAgentTransport (Microsoft.SmartDevice.DeviceAgentTransport.dll 内)

構文

'宣言
Sub RegisterShutdownCallback ( _
    in_pCallback As IAgentTransportShutdownCallback, _
    in_pUnknown As Object _
)
'使用
Dim instance As IDeviceAgentTransport
Dim in_pCallback As IAgentTransportShutdownCallback
Dim in_pUnknown As Object

instance.RegisterShutdownCallback(in_pCallback, _
    in_pUnknown)

void RegisterShutdownCallback(
    IAgentTransportShutdownCallback in_pCallback,
    Object in_pUnknown
)

void RegisterShutdownCallback(
    [InAttribute] IAgentTransportShutdownCallback^ in_pCallback, 
    [InAttribute] Object^ in_pUnknown
)

function RegisterShutdownCallback(
    in_pCallback : IAgentTransportShutdownCallback, 
    in_pUnknown : Object
)

パラメータ

in_pCallback
型 : Microsoft.SmartDevice.DeviceAgentTransport.IAgentTransportShutdownCallback

シャットダウン通知を受け取るオブジェクト。

in_pUnknown
型 : System.Object

コールバックルーチンにパラメータとして渡されるインターフェイス Cookie。

例外

例外	条件
COMException	HRESULT 情報を提供します。 E_INVALIDARG - 無効な引数 E_FAIL - その他のエラー

COMException

HRESULT 情報を提供します。

E_INVALIDARG - 無効な引数
E_FAIL - その他のエラー

解説

エージェントは、デスクトップが明示的にシャットダウンされるとき、または clientshutdown.exe の実行によって conmanclient2.exe がシャットダウンされるときにシャットダウンされます。デバイスエージェントは、クリーンアップを実行して正常に終了するために、シャットダウン通知を受信するよう要求できます。デバイスエージェントでシャットダウン通知を受け取るためには、IAgentTransportShutdownCallback を実装するクラスを定義し、このメソッドを使用して登録する必要があります。

例

' Register the callback object with the Device Agent Transport.
Dim shutdownCallback As New ShutdownCallback()
transport.RegisterShutdownCallback(shutdownCallback, shutdownCallback)

// Register the callback object with the Device Agent Transport.
ShutdownCallback shutdownCallback = new ShutdownCallback();
transport.RegisterShutdownCallback(shutdownCallback, shutdownCallback);