DatagramSocket.BindServiceNameAsync Methode

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.

Überlädt

Name	Beschreibung
BindServiceNameAsync(String)	Startet einen Bindungsvorgang für einen DatagramSocket- an einen lokalen Dienstnamen.
BindServiceNameAsync(String, NetworkAdapter)	Startet einen Bindungsvorgang für ein DatagramSocket- an einen lokalen Dienstnamen und eine bestimmte Netzwerkschnittstelle.

BindServiceNameAsync(String)

Bearbeiten

Startet einen Bindungsvorgang für einen DatagramSocket- an einen lokalen Dienstnamen.

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName);

function bindServiceNameAsync(localServiceName)

Public Function BindServiceNameAsync (localServiceName As String) As IAsyncAction

Parameter

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

Anforderungen	Beschreibung
App-Funktionen	internetClientServer privateNetworkClientServer

Hinweise

Die BindServiceNameAsync--Methode bindet an die lokalen IP-Adressen aller Netzwerkschnittstellen auf dem lokalen Computer auf dem lokalen Dienstnamen oder UDP-Port, der im localServiceName Parameter angegeben ist. Wenn der localServiceName Parameter eine leere Zeichenfolge ist, wählt das System den lokalen UDP-Port aus, an den eine Bindung erfolgen soll.

Sofern Sie die DatagramSocketControl.MulticastOnly-Eigenschaft nicht verwendet haben, schlägt die BindServiceNameAsync- Methode fehl, wenn eine andere App, die UDP verwendet (z. B. ein anderes DatagramSocket), bereits an den lokalen UDP-Port gebunden wurde, der im localServiceName Parameter angegeben ist.

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

Die BindServiceNameAsync- und BindEndpointAsync- Methoden 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 zu empfangen.

Siehe auch

Gilt für:

BindServiceNameAsync(String, NetworkAdapter)

Bearbeiten

Startet einen Bindungsvorgang für ein DatagramSocket- an einen lokalen Dienstnamen und eine bestimmte Netzwerkschnittstelle.

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName, NetworkAdapter ^ adapter) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, NetworkAdapter const& adapter);

[Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, NetworkAdapter adapter);

function bindServiceNameAsync(localServiceName, adapter)

Public Function BindServiceNameAsync (localServiceName As String, adapter As NetworkAdapter) As IAsyncAction

Parameter

localServiceName: String
Platform::String

winrt::hstring

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

adapter: NetworkAdapter

Der Netzwerkadapter, auf dem das DatagramSocket-objekt gebunden werden soll.

Gibt zurück

IAsyncAction

Ein asynchroner Bindungsvorgang für ein DatagramSocket--Objekt.

Attribute: OverloadAttribute RemoteAsyncAttribute

Hinweise

Die [BindServiceNameAsync(String, NetworkAdapter)-Methode bindet an eine Netzwerkschnittstelle, die im Adapter Parameter und den lokalen Dienstnamen oder UDP-Port angegeben im localServiceName Parameter auf dem lokalen Computer angegeben ist. Wenn der localServiceName Parameter eine leere Zeichenfolge ist, wählt das System den lokalen UDP-Port aus, an den eine Bindung erfolgen soll. Wenn der Adapter Parameter null ist, tritt ein Fehler auf.

Der von der [BindServiceNameAsync(String, NetworkAdapter)-Methode verwendete Namensauflösungsmechanismus ist auf die angegebene Schnittstelle für den DNS-Namespace (Domain Name System) beschränkt.

Sofern Sie die eigenschaft DatagramSocketControl.MulticastOnly nicht verwendet haben, schlägt die BindServiceNameAsync-Methode fehl, wenn eine andere App, die UDP verwendet (z. B. ein anderer DatagramSocket), bereits an den lokalen UDP-Port gebunden wurde, der im localServiceName Parameter auf derselben Netzwerkschnittstelle angegeben ist.

Die Bindung ist für den Empfang von Daten von einem beliebigen Remoteendpunkt auf einem DatagramSocket-unerlässlich und wird häufig ausgeführt, nachdem ein Socket erstellt wurde und das MessageReceived-Ereignis festgelegt wurde. Die BindServiceNameAsync- oder BindEndpointAsync--Methode wird verwendet, um eine DatagramSocket- an einen lokalen Dienstnamen oder UDP-Port zu binden. Die ConnectAsync--Methoden führen auch zu einem Bindungsvorgang, können aber nicht auf einen bestimmten Netzwerkadapter beschränkt werden. Das Schreiben in einen Von einem der GetOutputStreamAsync- Methoden zurückgegebenen Datenstrom führt auch zu einem Bindungsvorgang, wenn der Socket noch nicht gebunden ist, aber nicht auf einen bestimmten Netzwerkadapter beschränkt werden kann.

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 zu empfangen.

Wenn die [BindServiceNameAsync(String, NetworkAdapter)-Methode verwendet wird, schränkt der Bindungsvorgang eingehende und ausgehende Multicast- und Unicastpakete auf den angegebenen Adapter ein.

Die Verwendung des angegebenen Netzwerkadapters erfolgt auf best-effort-Basis. Unter anderem können Systeme mit Adaptern, die in schwachen Host- oder Weiterleitungsmodi konfiguriert sind, einen anderen Adapter als den angegebenen Adapter verwenden.

Siehe auch

Gilt für:

Feedback

War diese Seite hilfreich?