IDeviceAgentTransport::AcknowledgeLaunch
Mise à jour : novembre 2007
Enregistre un tableau d'ID de service. L'agent Smart Device peut accepter des demandes de connexion de l'ordinateur de développement dont l'ID de service figure dans le tableau.
HRESULT AcknowledgeLaunch([in] DWORD in_ArraySize, [size_is][in] LPCOLESTR in_szServiceIds[])
Paramètres
in_ArraySize
Taille du tableau des ID de service.in_szServiceIds
ID de service sur lesquels l'agent accepte les connexions.
Valeur de retour
Valeur HRESULT qui indique le résultat de l'appel de méthode.
Notes
Les ID de service sont utilisés par l'agent Smart Device pour identifier les demandes de connexion qu'il peut accepter. L'agent Smart Device peut accepter uniquement des connexions dont les ID de service ont été enregistrés par le biais de cette méthode.
Les ID de service ne peuvent pas contenir d'espaces ou être l'un des ID de service réservés tels que "", "Host", "Transport", "Shutdown" ou "Accept". Pour garantir le caractère unique, les GUID générés par ordinateur sont souvent utilisés comme ID de service. Pour générer un GUID, sélectionnez Create GUID dans le menu Outils.
Exemple
Cet exemple appelle AcknowledgeLaunch pour informer l'objet RemoteAgent sur l'ordinateur de bureau que l'agent Smart Device s'exécute sur l'appareil. Pour accéder à l'intégralité de l'exemple, consultez la rubrique 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);
Équivalent managé
IDeviceAgentTransport.AcknowledgeLaunch
Configuration requise
DeviceAgentTransport.h