RemoteAgent.Start メソッド

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

更新 : 2007 年 11 月

Id で指定されたパッケージ内のコマンドに従って、デバイスにデバイスエージェントを配置します。

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

構文

'宣言
Public Sub Start ( _
    arguments As String _
)
'使用
Dim instance As RemoteAgent
Dim arguments As String

instance.Start(arguments)

public void Start(
    string arguments
)

public:
void Start(
    String^ arguments
)

public function Start(
    arguments : String
)

パラメータ

arguments
型 : System.String

サービスを開始するときに渡すコマンドライン引数。

例外

例外	条件
SmartDeviceException	基になる COM コンポーネントによって COM 例外がスローされた場合に発生します。
DeviceNotConnectedException	デバイスが接続されていない場合に発生します。

解説

リモートエージェントを開始すると、同じ ID を持つパッケージが検索され、パッケージで定義されている設定に従ってエージェントが配置されます。パッケージは、開発用コンピュータとデータを交換するデバイスエージェントを配置するようにリモートエージェントに指示します。詳細については、「アドオンパッケージの概要」を参照してください。

エージェントのインスタンスがデバイスで既に実行されている場合、メソッドは、そのエージェントを停止してから再び起動します。

配置が行われるのは、デバイスに古いバージョンのエージェントが存在する場合だけです。

例

' Copy and start a device agent based on the ID of its add-on package.
Dim ra As RemoteAgent = device.GetRemoteAgent( _
    New ObjectId("CAF078AE-2E10-43e2-B566-C4577F2538C7"))
ra.Start("command line argument")

// Copy and start a device agent  based on the ID of its add-on package.
RemoteAgent ra = device.GetRemoteAgent(
    new ObjectId("CAF078AE-2E10-43e2-B566-C4577F2538C8"));
ra.Start("command line argument");