語言

StreamSocketListener.BindServiceNameAsync 方法

定義

多載

名稱 Description
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 物件。 對於藍牙 RFCOMM,這個參數是藍牙服務 ID。

傳回

StreamSocketListener 物件上的非同步綁定操作。

屬性

備註

BindServiceNameAsync(String) 方法會綁定到本地電腦上所有網路介面的本地 IP 位址,以及 localServiceName 參數中指定的本地服務名稱或 TCP 埠。 如果 localServiceName 參數是空字串,系統會選擇本地 TCP 埠來綁定。

對於藍牙 RFCOMM,此方法綁定於所有藍牙介面中 localServiceName 參數中指定的藍牙服務 ID。 綁定藍牙必須提供藍牙服務 ID。

如果另一個應用程式(例如另一個 StreamSocketListener)已經綁定到本地 TCP 埠或 localServiceName 參數中指定的藍牙服務 ID,BindServiceNameAsync(String) 方法就會失敗。

另請參閱

適用於

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 物件。 對於藍牙 RFCOMM,這個參數是藍牙服務 ID。

protectionLevel
SocketProtectionLevel

加密時設定的保護等級,適用於任何綁定的套接字。

傳回

StreamSocketListener 物件上的非同步綁定操作。

屬性

備註

[BindServiceNameAsync(String, SocketProtectionLevel) 方法會綁定到本地電腦上所有網路介面的本地 IP 位址,以及 localServiceName 參數中指定的本地服務名稱或 TCP 埠。 對於藍牙 RFCOMM,此方法綁定於所有藍牙介面中 localServiceName 參數中指定的藍牙服務 ID。 此方法將任何綁定套接字加密的保護等級設定為 protectionLevel 參數。

如果 localServiceName 參數是空字串,系統會選擇本地 TCP 埠來綁定。 綁定藍牙必須提供藍牙服務 ID。

如果另一個應用程式(例如另一個 StreamSocketListener)已經綁定到本地 TCP 埠或 localServiceName 參數中指定的藍牙服務 ID,則 [BindServiceNameAsync(String, SocketProtectionLevel) 方法將會失敗。

除了藍牙使用外,所有插座必須將 protectionLevel 參數設為 PlainSocket 。 當套接字要透過藍牙使用時, protectionLevel 參數可設定為 PlainSocket、 BluetoothEncryptionAllowNullAuthentication 或 BluetoothEncryptionWithAuthentication。 欲了解更多資訊,請參閱 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 物件。 對於藍牙 RFCOMM,這個參數是藍牙服務 ID。

protectionLevel
SocketProtectionLevel

加密時設定的保護等級,適用於任何綁定的套接字。

adapter
NetworkAdapter

用於綁定 StreamSocketListener 物件的網路介面卡。

傳回

StreamSocketListener 物件上的非同步綁定操作。

屬性

備註

[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 方法會綁定到本地電腦上網路介面卡中指定的 localServiceName 參數中的服務名稱或 TCP 埠。 對於藍牙 RFCOMM,若 localServiceName 參數為空,此方法會綁定至 localServiceName 參數中指定的藍牙服務 ID。 綁定藍牙必須提供藍牙服務 ID。 若介面 卡 參數中指定了網路介面卡,且 localServiceName 參數包含藍牙服務 ID,則此方法將失敗。

此方法將任何綁定套接字加密的保護等級設定為 protectionLevel 參數。

如果 localServiceName 參數是空字串,系統會選擇本地 TCP 埠來綁定。 若 TCP socket 綁定的 介面參數 為 空 ,則會發生錯誤。

[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 方法所使用的名稱解析機制,僅限於網域名稱系統(DNS)命名空間的指定介面。

如果另一個應用程式(例如另一個 StreamSocketListener)已經綁定到當地 localServiceName 參數中指定的網路介面卡埠,則 [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 方法將失敗。 對於藍牙,若其他應用程式(例如另一個 StreamSocketListener)已被綁定到 localServiceName 參數中指定的藍牙服務 ID,此方法將失敗。

使用指定的網路卡則是盡力而為。 若系統的介面卡設定為弱主機或轉發模式,可能會使用非指定介面卡的介面卡。

除了藍牙使用外,所有插座必須將 protectionLevel 參數設為 PlainSocket 。 當套接字要透過藍牙使用時, protectionLevel 參數可設定為 PlainSocket、 BluetoothEncryptionAllowNullAuthentication 或 BluetoothEncryptionWithAuthentication。 欲了解更多資訊,請參閱 SocketProtectionLevel 列舉。

另請參閱

適用於