Share via

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

要系結 StreamSocketListener 物件的本機服務名稱或 TCP 埠。 針對藍牙 RFCOMM，此參數是藍牙服務識別碼。

傳回

IAsyncAction

StreamSocketListener物件上的非同步系結作業。

屬性
RemoteAsyncAttribute

備註

BindServiceNameAsync (String) 方法會系結至本機電腦上所有網路介面的本機 IP 位址，以及 localServiceName 參數中指定的本機服務名稱或 TCP 埠。 如果 localServiceName 參數是空字串，則系統會選取要系結的本機 TCP 埠。

針對藍牙 RFCOMM，此方法會系結至所有藍牙介面上 localServiceName 參數中指定的藍牙服務識別碼。 必須提供藍牙服務識別碼，才能系結藍牙。

如果另一個應用程式 (另一個 StreamSocketListener，BindServiceNameAsync (String) 方法將會失敗，例如，) 已經系結至 localServiceName 參數中指定的本機 TCP 埠或藍牙服務識別碼。

另請參閱

適用於

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，此參數是藍牙服務識別碼。

protectionLevel
SocketProtectionLevel

要在任何系結通訊端上設定之加密的保護層級。

傳回

IAsyncAction

StreamSocketListener物件上的非同步系結作業。

屬性
OverloadAttribute RemoteAsyncAttribute

備註

[BindServiceNameAsync (String， SocketProtectionLevel) 方法會系結至本機電腦上所有網路介面的本機 IP 位址，以及 localServiceName 參數中指定的本機服務名稱或 TCP 埠。 針對藍牙 RFCOMM，此方法會系結至所有藍牙介面上 localServiceName 參數中指定的藍牙服務識別碼。 這個方法會將任何系結通訊端上的加密保護層級設定為 protectionLevel 參數。

如果 localServiceName 參數是空字串，則系統會選取要系結的本機 TCP 埠。 必須提供藍牙服務識別碼，才能系結藍牙。

如果另一個應用程式 (另一個 StreamSocketListener，則 [BindServiceNameAsync (String、 SocketProtectionLevel) 方法將會失敗，例如) 已經系結至 localServiceName 參數中指定的本機 TCP 埠或藍牙服務識別碼。

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

要系結 StreamSocketListener 物件的本機服務名稱或 TCP 埠。 針對藍牙 RFCOMM，此參數是藍牙服務識別碼。

protectionLevel
SocketProtectionLevel

要在任何系結通訊端上設定之加密的保護層級。

adapter
NetworkAdapter

要系結 StreamSocketListener 物件的網路介面卡。

傳回

IAsyncAction

StreamSocketListener物件上的非同步系結作業。

屬性
OverloadAttribute RemoteAsyncAttribute

備註

[BindServiceNameAsync (String， SocketProtectionLevel， NetworkAdapter) 方法會系結至本機電腦之網路介面卡上網路介面卡上，在localServiceName參數中指定的本機服務名稱或 TCP 埠。 針對藍牙 RFCOMM，如果配接器參數為null，這個方法會系結至localServiceName參數中指定的藍牙服務識別碼。 必須提供藍牙服務識別碼，才能系結藍牙。 如果在 配 接器參數中指定網路介面卡，且 localServiceName 參數包含藍牙服務識別碼，則此方法將會失敗。

這個方法會將任何系結通訊端上的加密保護層級設定為 protectionLevel 參數。

如果 localServiceName 參數是空字串，則系統會選取要系結的本機 TCP 埠。 如果 TCP 通訊端系結的 配接器 參數為 Null ，就會發生錯誤。

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

如果另一個應用程式 (另一個StreamSocketListener，則 [BindServiceNameAsync (String、 SocketProtectionLevel、 NetworkAdapter) 方法將會失敗，例如，) 已經系結至適配卡參數所指定網路介面卡上localServiceName參數中指定的本機 TCP 埠。 針對藍牙，如果另一個應用程式 (另一個 StreamSocketListener，則此方法將會失敗，例如，) 已經系結至 localServiceName 參數中指定的藍牙服務識別碼。

使用指定的網路介面卡是盡最大努力。 在弱式主機或轉送模式中設定介面卡的系統，可能會使用指定配接器以外的配接器。

protectionLevel參數必須針對所有通訊端設定為PlainSocket，但透過藍牙所使用的通訊端除外。 當通訊端是透過藍牙使用時， protectionLevel 參數可以設定為 PlainSocket、 BluetoothEncryptionAllowNullAuthentication或 BluetoothEncryptionWithAuthentication。 如需詳細資訊，請參閱 SocketProtectionLevel 列舉。

另請參閱

適用於