IDeviceAgentTransport.AcknowledgeLaunch - метод
Обновлен: Ноябрь 2007
Регистрирует массив идентификаторов служб. Агент устройства может принимать запросы на подключение от компьютера разработчика, идентификатор службы которого содержится в массиве.
Пространство имен: Microsoft.SmartDevice.DeviceAgentTransport
Сборка: Microsoft.SmartDevice.DeviceAgentTransport (в Microsoft.SmartDevice.DeviceAgentTransport.dll)
Синтаксис
'Декларация
Sub AcknowledgeLaunch ( _
in_ArraySize As UInteger, _
in_szServiceIds As String() _
)
'Применение
Dim instance As IDeviceAgentTransport
Dim in_ArraySize As UInteger
Dim in_szServiceIds As String()
instance.AcknowledgeLaunch(in_ArraySize, _
in_szServiceIds)
void AcknowledgeLaunch(
uint in_ArraySize,
string[] in_szServiceIds
)
void AcknowledgeLaunch(
[InAttribute] unsigned int in_ArraySize,
[InAttribute] array<String^>^ in_szServiceIds
)
function AcknowledgeLaunch(
in_ArraySize : uint,
in_szServiceIds : String[]
)
Параметры
- in_ArraySize
Тип: System.UInt32
Размер массива идентификаторов служб.
- in_szServiceIds
Тип: array<System.String[]
Идентификаторы служб, по которым агент принимает подключения.
Исключения
Исключение | Условие |
---|---|
COMException | Информация HRESULT:
|
ArgumentNullException | Если аргумент in_szServiceIds имеет нулевое значение "NULL". |
Заметки
Идентификаторы служб используются агентом устройства для определения запросов на подключение, которые он может принять. Агент устройства может принять только подключения, идентификаторы служб которых были зарегистрированы с помощью этого метода.
Идентификаторы служб не должны содержать пробелов или иметь названия, как у зарезервированных служебных идентификаторов, такие как "", "Host", "Transport", "Shutdown" или "Accept". Чтобы гарантировать уникальность, в качестве идентификаторов часто используются автоматически создаваемые глобальные уникальные идентификаторы (GUID). Чтобы создать GUID, выберите Создать GUID в меню Сервис.
Примеры
Dim serviceids(0 To 0) As String
serviceids(0) = "2FAD740C-B5D3-4ad0-BE23-5682503584BF"
' Get an instance of Device Agent Transport
Dim transport As IDeviceAgentTransport = _
DeviceAgentTransportFactory.GetAgentTransport()
' Register the callback object with the Device Agent Transport.
Dim shutdownCallback As New ShutdownCallback()
transport.RegisterShutdownCallback(shutdownCallback, shutdownCallback)
' Let the desktop application know that this device agent was deployed successfully
' and will handle the supplied list of service IDs.
transport.AcknowledgeLaunch(Convert.ToUInt32(serviceids.Length), serviceids)
' Open a communcation stream with desktop application on the service.
Dim packetStream As IDevicePacketStream
transport.AcceptConnectionEx(serviceids(0), packetStream)
string[] serviceids = { "2FAD740C-B5D3-4ad0-BE23-5682503584BF" };
// Get an instance of Device Agent Transport
IDeviceAgentTransport transport = DeviceAgentTransportFactory.GetAgentTransport();
// Register the callback object with the Device Agent Transport.
ShutdownCallback shutdownCallback = new ShutdownCallback();
transport.RegisterShutdownCallback(shutdownCallback, shutdownCallback);
// Let the desktop application know that this device agent was deployed successfully
// and will handle the supplied list of service IDs.
transport.AcknowledgeLaunch(Convert.ToUInt32(serviceids.Length), serviceids);
// Open a communcation stream with desktop application on the service.
IDevicePacketStream packetStream;
transport.AcceptConnectionEx(serviceids[0], out packetStream);
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.
См. также
Ссылки
IDeviceAgentTransport Интерфейс
Microsoft.SmartDevice.DeviceAgentTransport - пространство имен