IDeviceAgentTransport::AcknowledgeLaunch
Aktualisiert: November 2007
Registriert ein Dienst-ID-Array. Der Geräte-Agent kann Verbindungsanforderungen vom Entwicklungscomputer annehmen, deren Dienst-ID im Array enthalten ist.
HRESULT AcknowledgeLaunch([in] DWORD in_ArraySize, [size_is][in] LPCOLESTR in_szServiceIds[])
Parameter
in_ArraySize
Größe des Dienst-ID-Arrays.in_szServiceIds
Dienst-IDs, für die der Agent Verbindungen akzeptiert.
Rückgabewert
Ein HRESULT-Wert, der das Ergebnis des Methodenaufrufs angibt.
Hinweise
Dienst-IDs werden vom Geräte-Agent verwendet, um anzugeben, welche Verbindungsanforderungen der Geräte-Agent akzeptieren darf. Der Geräte-Agent kann nur Verbindungen akzeptieren, deren Dienst-IDs mithilfe dieser Methode registriert wurden.
Dienst-IDs dürfen keine Leerzeichen enthalten bzw. keine der reservierten Dienst-IDs "", "Host", "Transport", "Shutdown" oder "Accept" darstellen. Um die Eindeutigkeit sicherzustellen, werden häufig vom Computer generierte GUIDs als Dienst-IDs verwendet. Um eine GUID zu generieren, wählen Sie im Menü Extras den Befehl GUID erstellen aus.
Beispiel
Durch dieses Beispiel wird AcknowledgeLaunch aufgerufen, um das RemoteAgent-Objekt auf dem Desktop darüber zu informieren, dass der Geräte-Agent auf dem Gerät ausgeführt wird. Das vollständige Beispiel finden Sie unter 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);
Verwaltete Entsprechung
IDeviceAgentTransport.AcknowledgeLaunch
Anforderungen
DeviceAgentTransport.h