RemoteAgent.Start - метод
Обновлен: Ноябрь 2007
Развертывает агент устройства на устройстве в соответствии с командами в пакете, указанном в свойстве 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 | Возникает, если устройство не подключено. |
Заметки
После запуска удаленный агент выполняет поиск пакета с аналогичным идентификатором и затем развертывает файлы агента в соответствии с параметрами, определенными в пакете. Пакет сообщает удаленному агенту, что необходимо развернуть агент устройства, который будет осуществлять обмен данными с компьютером разработчика. Дополнительные сведения см. в разделе Общие сведения о пакетах надстроек.
Если экземпляр агента уже функционирует на устройстве, метод сначала остановит работу агента, а затем начнет ее снова.
Развертывание происходит, только если на устройстве установлена более ранняя версия агента.
Примеры
' 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");
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.