StreamSocketListener.BindServiceNameAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| BindServiceNameAsync(String) |
在 StreamSocketListener 上启动绑定到本地服务名称的绑定操作。 |
| BindServiceNameAsync(String, SocketProtectionLevel) |
在 StreamSocketListener 上启动绑定操作,以使用指定的 SocketProtectionLevel 将本地服务名称设置为任何绑定套接字。 |
| BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) |
在 StreamSocketListener 上启动套接字绑定操作,以使用指定的 SocketProtectionLevel 在指定的网络适配器上将本地服务名称设置为任何绑定套接字。 |
BindServiceNameAsync(String)
在 StreamSocketListener 上启动绑定到本地服务名称的绑定操作。
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
参数
- localServiceName
-
String
Platform::String
winrt::hstring
要绑定 StreamSocketListener 对象的本地服务名称或 TCP 端口。 对于蓝牙 RFCOMM,此参数为蓝牙服务 ID。
返回
StreamSocketListener 对象的异步绑定操作。
- 属性
注解
BindServiceNameAsync(String) 方法绑定到本地计算机上的所有网络接口的本地 IP 地址,以及 localServiceName 参数中指定的本地服务名称或 TCP 端口。 如果 localServiceName 参数是空字符串,则系统会选择要绑定的本地 TCP 端口。
对于蓝牙 RFCOMM,此方法绑定到所有蓝牙接口的 localServiceName 参数中指定的蓝牙服务 ID。 必须提供蓝牙服务 ID 才能绑定蓝牙。
如果另一个应用(例如,另一个 StreamSocketListener)已绑定到 localServiceName 参数中指定的本地 TCP 端口或蓝牙服务 ID,BindServiceNameAsync(String) 方法将失败。
另请参阅
- BindEndpointAsync(HostName, String)
- BindServiceNameAsync(String, SocketProtectionLevel)
- BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)
- StreamSocketListenerInformation
适用于
BindServiceNameAsync(String, SocketProtectionLevel)
在 StreamSocketListener 上启动绑定操作,以使用指定的 SocketProtectionLevel 将本地服务名称设置为任何绑定套接字。
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
参数
- localServiceName
-
String
Platform::String
winrt::hstring
要绑定 StreamSocketListener 对象的本地服务名称或 TCP 端口。 对于蓝牙 RFCOMM,此参数为蓝牙服务 ID。
- protectionLevel
- SocketProtectionLevel
要在任何绑定套接字上设置的加密的保护级别。
返回
StreamSocketListener 对象的异步绑定操作。
- 属性
注解
[BindServiceNameAsync(String, SocketProtectionLevel) 方法绑定到本地计算机上的所有网络接口的本地 IP 地址,以及 localServiceName 参数中指定的本地服务名称或 TCP 端口。 对于蓝牙 RFCOMM,此方法绑定到所有蓝牙接口的 localServiceName 参数中指定的蓝牙服务 ID。 此方法将任何绑定套接字上的加密保护级别设置为 protectionLevel 参数。
如果 localServiceName 参数是空字符串,则系统会选择要绑定的本地 TCP 端口。 必须提供蓝牙服务 ID 才能绑定蓝牙。
如果另一个应用(例如另一个 StreamSocketListener)已绑定到 localServiceName 参数中指定的本地 TCP 端口或蓝牙服务 ID,则 [BindServiceNameAsync(String, SocketProtectionLevel) 方法将失败。
除了蓝牙上使用的套接字之外, protectionLevel 参数必须设置为 PlainSocket 。 当套接字用于蓝牙时, protectionLevel 参数可以设置为 PlainSocket、 BluetoothEncryptionAllowNullAuthentication 或 BluetoothEncryptionWithAuthentication。 有关详细信息,请参阅 SocketProtectionLevel 枚举。
另请参阅
- BindEndpointAsync(HostName, String)
- BindServiceNameAsync(String)
- SocketProtectionLevel
- StreamSocketListenerInformation
适用于
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)
在 StreamSocketListener 上启动套接字绑定操作,以使用指定的 SocketProtectionLevel 在指定的网络适配器上将本地服务名称设置为任何绑定套接字。
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
参数
- localServiceName
-
String
Platform::String
winrt::hstring
要绑定 StreamSocketListener 对象的本地服务名称或 TCP 端口。 对于蓝牙 RFCOMM,此参数为蓝牙服务 ID。
- protectionLevel
- SocketProtectionLevel
要在任何绑定套接字上设置的加密的保护级别。
- adapter
- NetworkAdapter
要在其中绑定 StreamSocketListener 对象的网络适配器。
返回
StreamSocketListener 对象的异步绑定操作。
- 属性
注解
[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 方法绑定到本地计算机上适配器参数中指定的 localServiceName 参数中指定的本地服务名称或 TCP 端口。 对于蓝牙 RFCOMM,如果适配器参数为 null,此方法将绑定到 localServiceName 参数中指定的蓝牙服务 ID。 必须提供蓝牙服务 ID 才能绑定蓝牙。 如果在 适配器 参数中指定了网络适配器, 并且 localServiceName 参数包含蓝牙服务 ID,则此方法将失败。
此方法将任何绑定套接字上的加密保护级别设置为 protectionLevel 参数。
如果 localServiceName 参数是空字符串,则系统会选择要绑定的本地 TCP 端口。 如果 TCP 套接字绑定的 适配器 参数为 null ,则会发生错误。
[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 方法使用的名称解析机制仅限于域名系统 (DNS) 命名空间的指定接口。
如果另一个应用(例如,另一个 StreamSocketListener)已绑定到适配器参数中指定的网络适配器上的 localServiceName 参数中指定的本地 TCP 端口,则 [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 方法将失败。 对于蓝牙,如果另一个应用(例如,另一个 StreamSocketListener)已绑定到 localServiceName 参数中指定的蓝牙服务 ID,则此方法将失败。
使用指定的网络适配器是尽最大努力的。 在弱主机或转发模式下配置的适配器的系统可以使用指定的适配器以外的适配器。
除了蓝牙上使用的套接字之外, protectionLevel 参数必须设置为 PlainSocket 。 当套接字用于蓝牙时, protectionLevel 参数可以设置为 PlainSocket、 BluetoothEncryptionAllowNullAuthentication 或 BluetoothEncryptionWithAuthentication。 有关详细信息,请参阅 SocketProtectionLevel 枚举。
另请参阅
- BindServiceNameAsync(String)
- BindServiceNameAsync(String, SocketProtectionLevel)
- SocketProtectionLevel
- StreamSocketListenerInformation