DatagramSocket.BindEndpointAsync(HostName, String) Methode

Referenz

Definition

Namespace:: Windows.Networking.Sockets

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Startet einen Bindungsvorgang für ein DatagramSocket an einen lokalen Hostnamen und einen lokalen Dienstnamen.

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);

function bindEndpointAsync(localHostName, localServiceName)

Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

Parameter

localHostName: HostName

Der lokale Hostname oder die IP-Adresse, an die das DatagramSocket-Objekt gebunden werden soll.

localServiceName: String
Platform::String

winrt::hstring

Der Name des lokalen Diensts oder der UDP-Port, an den das DatagramSocket-Objekt gebunden werden soll.

Gibt zurück

IAsyncAction

Ein asynchroner Bindungsvorgang für ein DatagramSocket-Objekt .

Attribute: RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Hinweise

Die BindEndpointAsync-Methode bindet das DatagramSocket an den lokalen Hostnamen oder die ip-Adresse, die im localHostName-Parameter angegeben ist, und an den lokalen Dienstnamen oder die UDP-Portnummeradresse, die im parameter localServiceName angegeben ist. Wenn der localHostName-Parameter NULL ist, wählt das System die lokale IP-Adresse aus, an die gebunden werden soll. Wenn der parameter localServiceName eine leere Zeichenfolge ist, wählt das System den lokalen UDP-Port aus, an den gebunden werden soll.

Sofern Sie die DatagramSocketControl.MulticastOnly-Eigenschaft nicht verwendet haben, schlägt die BindEndpointAsync-Methode fehl, wenn eine andere App, die UDP verwendet (z. B. ein anderes DatagramSocket), bereits an die lokale IP-Adresse und den UDP-Port gebunden wurde, die in den Parametern localHostName und localServiceName angegeben sind.

Die Bindung ist für den Empfang von Daten von jedem Remoteendpunkt auf einem DatagramSocket unerlässlich und erfolgt in der Regel, nachdem ein Socket erstellt und das MessageReceived-Ereignis festgelegt wurde. Die BindServiceNameAsync - oder BindEndpointAsync-Methode wird verwendet, um ein DatagramSocket an einen lokalen Dienstnamen oder UDP-Port zu binden. Die ConnectAsync-Methoden führen auch zu einem Bindungsvorgang, wenn der Socket noch nicht gebunden ist. Das Schreiben in einen Stream, der von einer der GetOutputStreamAsync-Methoden zurückgegeben wird, führt ebenfalls zu einem Bindungsvorgang.

Die Methoden BindServiceNameAsync und BindEndpointAsync sind in den folgenden Fällen nicht erforderlich:

Das DatagramSocket wird nur zum Senden von Daten verwendet.
Das DatagramSocket wird verwendet, um Daten an einen einzelnen Endpunkt zu senden und von diesen zu empfangen.

Gilt für:

Freigeben über