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

Sub AcknowledgeLaunch ( _
    in_ArraySize As UInteger, _
    in_szServiceIds As String() _
)

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.UInt32

  Größe des Dienst-ID-Arrays.

• in_szServiceIds
  Typ: array<System.String[]

  Dienst-IDs, für die der Agent Verbindungen akzeptiert.

Ausnahmen

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.

Siehe auch

Referenz

IDeviceAgentTransport-Schnittstelle

IDeviceAgentTransport-Member

Microsoft.SmartDevice.DeviceAgentTransport-Namespace