Поделиться через

StreamSocketListener.BindServiceNameAsync Метод

  • Ссылка

Определение

Пространство имен:
Windows.Networking.Sockets

Перегрузки

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

Имя локальной службы или TCP-порт, к которому необходимо привязать объект StreamSocketListener . Для Bluetooth RFCOMM этот параметр является идентификатором службы Bluetooth.

Возвращаемое значение

IAsyncAction

Асинхронная операция привязки для объекта StreamSocketListener .

Атрибуты
RemoteAsyncAttribute

Комментарии

Метод BindServiceNameAsync(String) привязывается к локальным IP-адресам всех сетевых интерфейсов на локальном компьютере, а также к имени локальной службы или TCP-порту, указанному в параметре localServiceName . Если параметр localServiceName является пустой строкой, система выберет локальный TCP-порт, к которому требуется выполнить привязку.

Для Bluetooth RFCOMM этот метод привязывается к идентификатору службы Bluetooth, указанному в параметре localServiceName , на всех интерфейсах Bluetooth. Для привязки к Bluetooth необходимо указать идентификатор службы Bluetooth.

Метод BindServiceNameAsync(String) завершится ошибкой, если другое приложение (например, StreamSocketListener) уже привязано к локальному TCP-порту или идентификатору службы Bluetooth, указанному в параметре localServiceName .

См. также раздел

Применяется к

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

Имя локальной службы или TCP-порт, к которому необходимо привязать объект StreamSocketListener . Для Bluetooth RFCOMM этот параметр является идентификатором службы Bluetooth.

protectionLevel
SocketProtectionLevel

Уровень защиты для шифрования, устанавливаемого для любых привязанных сокетов.

Возвращаемое значение

IAsyncAction

Асинхронная операция привязки для объекта StreamSocketListener .

Атрибуты
OverloadAttribute RemoteAsyncAttribute

Комментарии

Метод [BindServiceNameAsync(String, SocketProtectionLevel) привязывается к локальным IP-адресам всех сетевых интерфейсов на локальном компьютере, а также к имени локальной службы или TCP-порту, указанному в параметре localServiceName . Для Bluetooth RFCOMM этот метод привязывается к идентификатору службы Bluetooth, указанному в параметре localServiceName , на всех интерфейсах Bluetooth. Этот метод задает уровень защиты для шифрования в любых связанных сокетах в параметре protectionLevel .

Если параметр localServiceName является пустой строкой, система выберет локальный TCP-порт, к которому требуется выполнить привязку. Для привязки к Bluetooth необходимо указать идентификатор службы Bluetooth.

Метод [BindServiceNameAsync(String, SocketProtectionLevel) завершится ошибкой, если другое приложение (например, Другое streamSocketListener) уже привязано к локальному TCP-порту или идентификатору службы Bluetooth, указанному в параметре localServiceName .

Параметр protectionLevel должен иметь значение PlainSocket для всех сокетов, кроме используемых по Bluetooth. Если сокет будет использоваться через Bluetooth, для параметра protectionLevel можно задать значение PlainSocket, BluetoothEncryptionAllowNullAuthentication или BluetoothEncryptionWithentication. Дополнительные сведения см. в перечислении SocketProtectionLevel .

См. также раздел

Применяется к

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

Имя локальной службы или TCP-порт, к которому необходимо привязать объект StreamSocketListener . Для Bluetooth RFCOMM этот параметр является идентификатором службы Bluetooth.

protectionLevel
SocketProtectionLevel

Уровень защиты для шифрования, устанавливаемого для любых привязанных сокетов.

adapter
NetworkAdapter

Сетевой адаптер, к которому необходимо привязать объект StreamSocketListener .

Возвращаемое значение

IAsyncAction

Асинхронная операция привязки для объекта StreamSocketListener .

Атрибуты
OverloadAttribute RemoteAsyncAttribute

Комментарии

Метод [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) привязывается к имени локальной службы или TCP-порту, указанному в параметре localServiceName на сетевом адаптере, указанном в параметре адаптера на локальном компьютере. Для Bluetooth RFCOMM этот метод привязывается к идентификатору службы Bluetooth, указанному в параметре localServiceName , если параметр адаптера имеет значение NULL. Для привязки к Bluetooth необходимо указать идентификатор службы Bluetooth. Если сетевой адаптер указан в параметре адаптера , а параметр localServiceName содержит идентификатор службы Bluetooth, этот метод завершится ошибкой.

Этот метод задает уровень защиты для шифрования в любых связанных сокетах в параметре protectionLevel .

Если параметр localServiceName является пустой строкой, система выберет локальный TCP-порт, к которому требуется выполнить привязку. Если параметр адаптера имеет значение NULL для привязки сокета TCP, возникнет ошибка.

Механизм разрешения имен, используемый методом [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter), ограничен указанным интерфейсом для пространства имен системы доменных имен (DNS).

Метод [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) завершится ошибкой, если другое приложение (например, StreamSocketListener) уже привязано к локальному TCP-порту, указанному в параметре localServiceName сетевого адаптера, указанного в параметре адаптера . Для Bluetooth этот метод завершится ошибкой, если другое приложение (например, StreamSocketListener) уже привязано к идентификатору службы Bluetooth, указанному в параметре localServiceName .

Использование указанного сетевого адаптера осуществляется на основе наилучших усилий. Система с адаптерами, настроенными в режиме слабого узла или переадресации, может использовать адаптер, отличный от указанного адаптера.

Параметр protectionLevel должен иметь значение PlainSocket для всех сокетов, кроме используемых по Bluetooth. Если сокет будет использоваться через Bluetooth, для параметра protectionLevel можно задать значение PlainSocket, BluetoothEncryptionAllowNullAuthentication или BluetoothEncryptionWithentication. Дополнительные сведения см. в перечислении SocketProtectionLevel .

См. также раздел

Применяется к