IDeviceAgentTransport.AcknowledgeLaunch-Methode
Aktualisiert: November 2007
Registriert ein Dienst-ID-Array. Der Geräte-Agent kann Verbindungsanforderungen vom Entwicklungscomputer annehmen, deren Dienst-ID im Array enthalten ist.
Namespace: Microsoft.SmartDevice.DeviceAgentTransport
Assembly: Microsoft.SmartDevice.DeviceAgentTransport (in Microsoft.SmartDevice.DeviceAgentTransport.dll)
Syntax
'Declaration
Sub AcknowledgeLaunch ( _
in_ArraySize As UInteger, _
in_szServiceIds As String() _
)
'Usage
Dim instance As IDeviceAgentTransport
Dim in_ArraySize As UInteger
Dim in_szServiceIds As String()
instance.AcknowledgeLaunch(in_ArraySize, _
in_szServiceIds)
void AcknowledgeLaunch(
uint in_ArraySize,
string[] in_szServiceIds
)
void AcknowledgeLaunch(
[InAttribute] unsigned int in_ArraySize,
[InAttribute] array<String^>^ in_szServiceIds
)
function AcknowledgeLaunch(
in_ArraySize : uint,
in_szServiceIds : String[]
)
Parameter
in_ArraySize
Typ: System.UInt32Größe des Dienst-ID-Arrays.
in_szServiceIds
Typ: array<System.String[]Dienst-IDs, für die der Agent Verbindungen akzeptiert.
Ausnahmen
Ausnahme | Bedingung |
---|---|
COMException | HRESULT-Informationen:
|
ArgumentNullException | Wenn in_szServiceIds als NULL angegeben wird. |
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.
Beispiele
Dim serviceids(0 To 0) As String
serviceids(0) = "2FAD740C-B5D3-4ad0-BE23-5682503584BF"
' Get an instance of Device Agent Transport
Dim transport As IDeviceAgentTransport = _
DeviceAgentTransportFactory.GetAgentTransport()
' Register the callback object with the Device Agent Transport.
Dim shutdownCallback As New ShutdownCallback()
transport.RegisterShutdownCallback(shutdownCallback, shutdownCallback)
' Let the desktop application know that this device agent was deployed successfully
' and will handle the supplied list of service IDs.
transport.AcknowledgeLaunch(Convert.ToUInt32(serviceids.Length), serviceids)
' Open a communcation stream with desktop application on the service.
Dim packetStream As IDevicePacketStream
transport.AcceptConnectionEx(serviceids(0), packetStream)
string[] serviceids = { "2FAD740C-B5D3-4ad0-BE23-5682503584BF" };
// Get an instance of Device Agent Transport
IDeviceAgentTransport transport = DeviceAgentTransportFactory.GetAgentTransport();
// Register the callback object with the Device Agent Transport.
ShutdownCallback shutdownCallback = new ShutdownCallback();
transport.RegisterShutdownCallback(shutdownCallback, shutdownCallback);
// Let the desktop application know that this device agent was deployed successfully
// and will handle the supplied list of service IDs.
transport.AcknowledgeLaunch(Convert.ToUInt32(serviceids.Length), serviceids);
// Open a communcation stream with desktop application on the service.
IDevicePacketStream packetStream;
transport.AcceptConnectionEx(serviceids[0], out packetStream);
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.