IDeviceAgentTransport::AcknowledgeLaunch
Обновлен: Ноябрь 2007
Регистрирует массив идентификаторов служб. Агент устройства может принимать запросы на подключение от компьютера разработчика, идентификатор службы которого содержится в массиве.
HRESULT AcknowledgeLaunch([in] DWORD in_ArraySize, [size_is][in] LPCOLESTR in_szServiceIds[])
Параметры
in_ArraySize
Размер массива идентификаторов служб.in_szServiceIds
Идентификаторы служб, по которым агент принимает подключения.
Возвращаемое значение
Значение HRESULT, указывающее, каков результат вызова метода.
Заметки
Идентификаторы служб используются агентом устройства для определения запросов на подключение, которые он может принять. Агент устройства может принять только подключения, идентификаторы служб которых были зарегистрированы с помощью этого метода.
Идентификаторы служб не должны содержать пробелов или иметь названия, как у зарезервированных служебных идентификаторов, такие как "", "Host", "Transport", "Shutdown" или "Accept". Чтобы гарантировать уникальность, в качестве идентификаторов часто используются автоматически создаваемые глобальные уникальные идентификаторы (GUID). Чтобы создать GUID, выберите Создать GUID в меню Сервис.
Пример
В этом примере вызывается AcknowledgeLaunch для оповещения объекта RemoteAgent на настольном компьютере о том, что агент устройства работает на устройстве. Полный пример см. в описании интерфейса IDeviceAgentTransport.
// Let the desktop application know that this remote agent was deployed successfully
// and that this remote agent will handle the supplied list of services.
LPCOLESTR szServiceIds[] = {L"F85E57BA-5AE9-4FF7-8433-6AB7D991D033"};
pTransport->AcknowledgeLaunch(1, szServiceIds);
// Open a communcation stream with desktop application on the service.
IDevicePacketStream *pStream = NULL;
pTransport->AcceptConnectionEx(szServiceIds[0], &pStream);
// Get an instance of IPacket
GetNewPacketFunc f2 = (GetNewPacketFunc) :: GetProcAddress(hmod, L"GetNewPacket");
IPacket *pPacket = NULL;
f2(&pPacket);
// Write a message and sent the packet.
pPacket->WriteBool(true);
pPacket->WriteByte(0xff);
pPacket->WriteChar('c');
pPacket->WriteInt32(1024);
pPacket->WriteString(L"Hello Desktop Computer");
pStream->Write(pPacket);
Управляемый эквивалент
IDeviceAgentTransport.AcknowledgeLaunch
Требования
DeviceAgentTransport.h