IDeviceAgentTransport.AcknowledgeLaunch - метод

Статья
11/05/2008

Обновлен: Ноябрь 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: E_INVALIDARG \| Недопустимые аргументы E_FAIL \| Возврат значения в случае любого другого сбоя
ArgumentNullException	Если аргумент in_szServiceIds имеет нулевое значение "NULL".

COMException

Информация HRESULT:

E_INVALIDARG | Недопустимые аргументы
E_FAIL | Возврат значения в случае любого другого сбоя

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 Интерфейс

IDeviceAgentTransport - члены

Microsoft.SmartDevice.DeviceAgentTransport - пространство имен

Поделиться через