更新:2007 年 11 月
註冊服務 ID 的陣列。裝置代理程式可以接受來自開發電腦 (其服務 ID 在陣列中) 的連接要求。
HRESULT AcknowledgeLaunch([in] DWORD in_ArraySize, [size_is][in] LPCOLESTR in_szServiceIds[])
參數
in_ArraySize
服務 ID 陣列的大小。in_szServiceIds
代理程式針對其接受連接的服務 ID。
傳回值
HRESULT 值,表示方法呼叫的結果。
備註
服務 ID 是由裝置代理程式用於識別裝置代理程式可以接受哪些連接要求。裝置代理程式只能接受已使用此方法註冊服務 ID 的連接。
服務 ID 不能包含空白或已保留的 ID,例如 ""、"Host"、"Transport"、"Shutdown" 或 "Accept"。若要確保唯一性,通常是使用機器產生的 GUID 做為服務 ID。若要產生 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);
Managed 對應項
IDeviceAgentTransport.AcknowledgeLaunch
需求
DeviceAgentTransport.h