RemoteAgent.Start-Methode

Článek
08/23/2008

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

'Declaration
Public Sub Start ( _
    arguments As String _
)
'Usage
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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

RemoteAgent-Klasse

RemoteAgent-Member

Microsoft.SmartDevice.Connectivity-Namespace

Sdílet prostřednictvím