IDeviceAgentTransport::AcknowledgeLaunch

Actualización: noviembre 2007

Registra una matriz de identificadores de servicio. El agente de dispositivos puede aceptar solicitudes de conexión del equipo de desarrollo cuyo identificador de servicio está en la matriz.

HRESULT AcknowledgeLaunch([in] DWORD in_ArraySize, [size_is][in] LPCOLESTR in_szServiceIds[])

Parámetros

  • in_ArraySize
    Tamaño de la matriz de identificadores de servicio.

  • in_szServiceIds
    Los identificadores de servicio en los que el agente acepta conexiones.

Valor devuelto

Un valor HRESULT que indica el resultado de la llamada al método.

Comentarios

El agente de dispositivos utiliza los identificadores de servicio para identificar qué solicitudes de conexión puede aceptar el agente de dispositivos. El agente de dispositivos sólo puede aceptar conexiones cuyos identificadores de servicio se hayan registrado utilizando este método.

Los identificadores de servicio no pueden contener espacios ni ser uno de los identificadores de servicio reservados como "", "Host", "Transport", "Shutdown" o "Accept". Para asegurarse de que los identificadores son únicos, se utilizan a menudo GUID generados por el equipo como identificadores de servicio. Para generar un GUID, seleccione Crear GUID en el menú Herramientas.

Ejemplo

En este ejemplo se llama a AcknowledgeLaunch para informar al objeto RemoteAgent en el escritorio de que el agente de dispositivos se está ejecutando en el dispositivo. Para obtener el ejemplo completo, consulte 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);

Equivalente administrado

IDeviceAgentTransport.AcknowledgeLaunch

Requisitos

DeviceAgentTransport.h

Vea también

Referencia

IDeviceAgentTransport