StreamSocketListener.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 StreamSocketListener an einen lokalen Dienstnamen.
BindServiceNameAsync(String, SocketProtectionLevel)	Startet einen Bindungsvorgang für einen StreamSocketListener an einen lokalen Dienstnamen mit einem angegebenen SocketProtectionLevel , der für alle gebundenen Sockets festgelegt werden soll.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)	Startet einen Socketbindungsvorgang für einen StreamSocketListener mit einem lokalen Dienstnamen auf einem angegebenen Netzwerkadapter mit einem angegebenen SocketProtectionLevel , der für alle gebundenen Sockets festgelegt werden soll.

BindServiceNameAsync(String)

Bearbeiten

Startet einen Bindungsvorgang für einen StreamSocketListener 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 TCP-Port, an den das StreamSocketListener-Objekt gebunden werden soll. Bei Bluetooth RFCOMM ist dieser Parameter die Bluetooth-Dienst-ID.

Gibt zurück

IAsyncAction

Der asynchrone Bindungsvorgang für ein StreamSocketListener-Objekt .

Attribute: RemoteAsyncAttribute

Hinweise

Die BindServiceNameAsync(String)-Methode bindet an die lokalen IP-Adressen aller Netzwerkschnittstellen auf dem lokalen Computer und an den lokalen Dienstnamen oder tcp-Port, der im parameter "localServiceName " angegeben ist. Wenn der parameter localServiceName eine leere Zeichenfolge ist, wählt das System den lokalen TCP-Port aus, an den eine Bindung erfolgen soll.

Bei Bluetooth RFCOMM bindet diese Methode an die Bluetooth-Dienst-ID, die im parameter localServiceName für alle Bluetooth-Schnittstellen angegeben ist. Für Bluetooth muss eine Bluetooth-Dienst-ID angegeben werden.

Die BindServiceNameAsync(String)-Methode schlägt fehl, wenn eine andere App (z. B. ein anderer StreamSocketListener) bereits an den lokalen TCP-Port oder die Bluetooth-Dienst-ID gebunden wurde, die im parameter "localServiceName " angegeben ist.

Siehe auch

Gilt für:

BindServiceNameAsync(String, SocketProtectionLevel)

Bearbeiten

Startet einen Bindungsvorgang für einen StreamSocketListener an einen lokalen Dienstnamen mit einem angegebenen SocketProtectionLevel , der für alle gebundenen Sockets festgelegt werden soll.

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

/// [Windows.Foundation.Metadata.Overload("BindServiceNameWithProtectionLevelAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, SocketProtectionLevel const& protectionLevel);

[Windows.Foundation.Metadata.Overload("BindServiceNameWithProtectionLevelAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, SocketProtectionLevel protectionLevel);

function bindServiceNameAsync(localServiceName, protectionLevel)

Public Function BindServiceNameAsync (localServiceName As String, protectionLevel As SocketProtectionLevel) As IAsyncAction

Parameter

localServiceName: String
Platform::String

winrt::hstring

Der name des lokalen Diensts oder der TCP-Port, an den das StreamSocketListener-Objekt gebunden werden soll. Bei Bluetooth RFCOMM ist dieser Parameter die Bluetooth-Dienst-ID.

protectionLevel: SocketProtectionLevel

Die Schutzebene für die Verschlüsselung, die für alle gebundenen Sockets festgelegt werden soll.

Gibt zurück

IAsyncAction

Der asynchrone Bindungsvorgang für ein StreamSocketListener-Objekt .

Attribute: OverloadAttribute RemoteAsyncAttribute

Hinweise

Die [BindServiceNameAsync(String, SocketProtectionLevel)-Methode bindet an die lokalen IP-Adressen aller Netzwerkschnittstellen auf dem lokalen Computer und an den lokalen Dienstnamen oder tcp-Port, der im parameter "localServiceName " angegeben ist. Bei Bluetooth RFCOMM bindet diese Methode an die Bluetooth-Dienst-ID, die im parameter localServiceName für alle Bluetooth-Schnittstellen angegeben ist. Diese Methode legt die Schutzebene für die Verschlüsselung für alle gebundenen Sockets auf den parameter protectionLevel fest.

Wenn der parameter localServiceName eine leere Zeichenfolge ist, wählt das System den lokalen TCP-Port aus, an den eine Bindung erfolgen soll. Für Bluetooth muss eine Bluetooth-Dienst-ID angegeben werden.

Die [BindServiceNameAsync(String, SocketProtectionLevel)-Methode schlägt fehl, wenn eine andere App (z. B. ein anderer StreamSocketListener) bereits an den lokalen TCP-Port oder die Bluetooth-Dienst-ID gebunden wurde, die im parameter "localServiceName " angegeben ist.

Der parameter protectionLevel muss für alle Sockets auf PlainSocket festgelegt werden, mit Ausnahme derjenigen, die über Bluetooth verwendet werden. Wenn der Socket über Bluetooth verwendet werden soll, kann der ProtectionLevel-Parameter auf PlainSocket, BluetoothEncryptionAllowNullAuthentication oder BluetoothEncryptionWithAuthentication festgelegt werden. Weitere Informationen finden Sie in der SocketProtectionLevel-Aufzählung .

Siehe auch

Gilt für:

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Bearbeiten

Startet einen Socketbindungsvorgang für einen StreamSocketListener mit einem lokalen Dienstnamen auf einem angegebenen Netzwerkadapter mit einem angegebenen SocketProtectionLevel , der für alle gebundenen Sockets festgelegt werden soll.

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

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

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

function bindServiceNameAsync(localServiceName, protectionLevel, adapter)

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

Parameter

localServiceName: String
Platform::String

winrt::hstring

Der name des lokalen Diensts oder der TCP-Port, an den das StreamSocketListener-Objekt gebunden werden soll. Bei Bluetooth RFCOMM ist dieser Parameter die Bluetooth-Dienst-ID.

protectionLevel: SocketProtectionLevel

Die Schutzebene für die Verschlüsselung, die für alle gebundenen Sockets festgelegt werden soll.

adapter: NetworkAdapter

Der Netzwerkadapter, auf dem das StreamSocketListener-Objekt gebunden werden soll.

Gibt zurück

IAsyncAction

Der asynchrone Bindungsvorgang für ein StreamSocketListener-Objekt .

Attribute: OverloadAttribute RemoteAsyncAttribute

Hinweise

Die [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)-Methode bindet an den lokalen Dienstnamen oder den TCP-Port, der im parameter localServiceNameauf dem netzwerkadapter auf dem lokalen Computer angegeben ist. Bei Bluetooth RFCOMM bindet diese Methode an die bluetooth-Dienst-ID, die im parameter localServiceName angegeben ist, wenn der Adapterparameternull ist. Für Bluetooth muss eine Bluetooth-Dienst-ID angegeben werden. Wenn ein Netzwerkadapter im Adapterparameter angegeben ist und der parameter localServiceName eine Bluetooth-Dienst-ID enthält, schlägt diese Methode fehl.

Diese Methode legt die Schutzebene für die Verschlüsselung für alle gebundenen Sockets auf den parameter protectionLevel fest.

Wenn der parameter localServiceName eine leere Zeichenfolge ist, wählt das System den lokalen TCP-Port aus, an den eine Bindung erfolgen soll. Wenn der Adapterparameternull für eine TCP-Socketbindung ist, tritt ein Fehler auf.

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

Die [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)-Methode schlägt fehl, wenn eine andere App (z. B. ein anderer StreamSocketListener) bereits an den lokalen TCP-Port gebunden wurde, der im parameter "localServiceName " auf dem im Adapterparameter angegebenen Netzwerkadapter angegeben ist. Bei Bluetooth schlägt diese Methode fehl, wenn eine andere App (z. B. ein anderer StreamSocketListener) bereits an die im parameter "localServiceName " angegebene Bluetooth-Dienst-ID gebunden wurde.

Die Verwendung des angegebenen Netzwerkadapters erfolgt auf best-effort-Basis. Ein System mit Adaptern, die in schwachen Host- oder Weiterleitungsmodi konfiguriert sind, kann einen anderen Adapter als den angegebenen Adapter verwenden.

Siehe auch

Gilt für:

Feedback

War diese Seite hilfreich?