Freigeben über


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

Siehe auch

Referenz

IDeviceAgentTransport