StreamSocketListener.BindServiceNameAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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) 方法就會失敗。
另請參閱
- 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
本地服務名稱或 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 列舉。
另請參閱
- 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
本地服務名稱或 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 列舉。
另請參閱
- BindServiceNameAsync(String)
- BindServiceNameAsync(String, SocketProtectionLevel)
- SocketProtectionLevel
- StreamSocketListenerInformation