Share via


RemoteAgent.Start-Methode

Aktualisiert: November 2007

Stellt den Geräte-Agent entsprechend den Befehlen in dem Paket, das durch Id angegeben wird, für das Gerät bereit.

Namespace:  Microsoft.SmartDevice.Connectivity
Assembly:  Microsoft.SmartDevice.Connectivity (in Microsoft.SmartDevice.Connectivity.dll)

Syntax

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
)

Parameter

  • arguments
    Typ: System.String

    Befehlszeilenargumente, die beim Starten des Dienstes übergeben werden sollen.

Ausnahmen

Ausnahme Bedingung
SmartDeviceException

Tritt auf, wenn durch zugrunde liegende COM-Komponenten eines COM-Ausnahme ausgelöst wird.

DeviceNotConnectedException

Tritt auf, wenn ein Gerät nicht verbunden ist.

Hinweise

Wenn Sie den Remote-Agent starten, sucht der Agent das Paket mit derselben ID und stellt den Agent dann entsprechend den im Paket definierten Einstellungen bereit. Durch das Paket wird der Remote-Agent angewiesen, einen Geräte-Agent bereitzustellen, durch den Daten mit dem Entwicklungscomputer ausgetauscht werden. Weitere Informationen finden Sie unter Übersicht über Add-On-Pakete.

Wenn bereits eine Instanz des Agents auf dem Gerät ausgeführt wird, wird der Agent von der Methode zuerst angehalten und dann erneut gestartet.

Die Bereitstellung findet nur statt, wenn eine frühere Version des Agents auf dem Gerät vorhanden ist.

Beispiele

' 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");

Berechtigungen

Siehe auch

Referenz

RemoteAgent-Klasse

RemoteAgent-Member

Microsoft.SmartDevice.Connectivity-Namespace