StreamSocketListener.BindServiceNameAsync Methode

Definition

Namespace:

Windows.Networking.Sockets

Überlädt

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 an einen lokalen Dienstnamen auf einem angegebenen Netzwerkadapter mit einem angegebenen SocketProtectionLevel , der für alle gebundenen Sockets festgelegt werden soll.

BindServiceNameAsync(String)

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. Für 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 wird an die lokalen IP-Adressen aller Netzwerkschnittstellen auf dem lokalen Computer und an den im localServiceName-Parameter angegebenen lokalen Dienstnamen oder TCP-Port gebunden. Wenn der parameter localServiceName eine leere Zeichenfolge ist, wählt das System den lokalen TCP-Port aus, an den gebunden werden soll.

Für Bluetooth RFCOMM wird diese Methode an die Bluetooth-Dienst-ID gebunden, die im Parameter localServiceName für alle Bluetooth-Schnittstellen angegeben ist. Für die Bindung 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 Im parameter localServiceName angegebene Bluetooth-Dienst-ID gebunden wurde.

Weitere Informationen

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String, SocketProtectionLevel)
• BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)
• StreamSocketListenerInformation

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.

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. Für 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 wird an die lokalen IP-Adressen aller Netzwerkschnittstellen auf dem lokalen Computer und an den im localServiceName-Parameter angegebenen lokalen Dienstnamen oder TCP-Port gebunden. Für Bluetooth RFCOMM wird diese Methode an die Bluetooth-Dienst-ID gebunden, 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 gebunden werden soll. Für die Bindung 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 Im parameter localServiceName angegebene Bluetooth-Dienst-ID gebunden wurde.

Der parameter protectionLevel muss für alle Sockets außer für die über Bluetooth verwendeten Sockets auf PlainSocket festgelegt werden. Wenn der Socket über Bluetooth verwendet werden soll, kann der protectionLevel-Parameter auf PlainSocket, BluetoothEncryptionAllowNullAuthentication oder BluetoothEncryptionWithAuthentication festgelegt werden. Weitere Informationen finden Sie unter SocketProtectionLevel-Enumeration .

Weitere Informationen

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String)
• SocketProtectionLevel
• StreamSocketListenerInformation

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Startet einen Socketbindungsvorgang für einen StreamSocketListener an einen 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. Für 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, an den 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 wird an den lokalen Dienstnamen oder TCP-Port gebunden, der im localServiceName-Parameter auf dem netzwerkadapter angegeben ist, der im Adapterparameter auf dem lokalen Computer angegeben ist. Für Bluetooth RFCOMM wird diese Methode an die Im parameter localServiceName angegebene Bluetooth-Dienst-ID gebunden, wenn der AdapterparameterNULL ist. Für die Bindung für Bluetooth muss eine Bluetooth-Dienst-ID angegeben werden. Wenn im Adapterparameter ein Netzwerkadapter 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 gebunden werden soll. Wenn der Adapterparameter für eine TCP-Socketbindung NULL ist, tritt ein Fehler auf.

Der von der Methode [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 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 des im Adapterparameter angegebenen Netzwerkadapters 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 der Grundlage der besten Leistung. Ein System mit Adaptern, die im Schwachhost- oder Weiterleitungsmodus konfiguriert sind, kann einen anderen Adapter als den angegebenen Adapter verwenden.

Der parameter protectionLevel muss für alle Sockets außer für die über Bluetooth verwendeten Sockets auf PlainSocket festgelegt werden. Wenn der Socket über Bluetooth verwendet werden soll, kann der protectionLevel-Parameter auf PlainSocket, BluetoothEncryptionAllowNullAuthentication oder BluetoothEncryptionWithAuthentication festgelegt werden. Weitere Informationen finden Sie unter SocketProtectionLevel-Enumeration .

Weitere Informationen

• BindServiceNameAsync(String)
• BindServiceNameAsync(String, SocketProtectionLevel)
• SocketProtectionLevel
• StreamSocketListenerInformation