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 ポート。 Bluetooth RFCOMM の場合、このパラメーターは Bluetooth サービス ID です。

戻り値

IAsyncAction

StreamSocketListener オブジェクトに対する非同期バインド操作。

属性
RemoteAsyncAttribute

注釈

BindServiceNameAsync(String) メソッドは、ローカル コンピューター上のすべてのネットワーク インターフェイスのローカル IP アドレスと、 localServiceName パラメーターで指定されたローカル サービス名または TCP ポートにバインドします。 localServiceName パラメーターが空の文字列の場合、システムはバインドするローカル TCP ポートを選択します。

Bluetooth RFCOMM の場合、このメソッドは、すべての Bluetooth インターフェイスの localServiceName パラメーターで指定された Bluetooth サービス ID にバインドします。 Bluetooth 用にバインドするには、Bluetooth サービス ID を指定する必要があります。

別のアプリ (別の StreamSocketListener など) が localServiceName パラメーターで指定されたローカル TCP ポートまたは Bluetooth サービス 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

StreamSocketListener オブジェクトをバインドするローカル サービス名または TCP ポート。 Bluetooth RFCOMM の場合、このパラメーターは Bluetooth サービス ID です。

protectionLevel
SocketProtectionLevel

バインドされたソケットに設定する暗号化の保護レベル。

戻り値

IAsyncAction

StreamSocketListener オブジェクトに対する非同期バインド操作。

属性
OverloadAttribute RemoteAsyncAttribute

注釈

[BindServiceNameAsync(String, SocketProtectionLevel) メソッドは、ローカル コンピューター上のすべてのネットワーク インターフェイスのローカル IP アドレスと、 localServiceName パラメーターで指定されたローカル サービス名または TCP ポートにバインドします。 Bluetooth RFCOMM の場合、このメソッドは、すべての Bluetooth インターフェイスの localServiceName パラメーターで指定された Bluetooth サービス ID にバインドします。 このメソッドは、バインドされたソケットでの暗号化の保護レベルを protectionLevel パラメーターに設定します。

localServiceName パラメーターが空の文字列の場合、システムはバインドするローカル TCP ポートを選択します。 Bluetooth 用にバインドするには、Bluetooth サービス ID を指定する必要があります。

[BindServiceNameAsync(String, SocketProtectionLevel) メソッドは、別のアプリ (別 の StreamSocketListener など) が localServiceName パラメーターで指定されたローカル TCP ポートまたは Bluetooth サービス ID に既にバインドされている場合に失敗します。

Bluetooth 経由で使用されるソケットを除くすべてのソケットに対して、protectionLevel パラメーターを PlainSocket に設定する必要があります。 ソケットを Bluetooth 経由で使用する場合は、 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 ポート。 Bluetooth RFCOMM の場合、このパラメーターは Bluetooth サービス ID です。

protectionLevel
SocketProtectionLevel

バインドされたソケットに設定する暗号化の保護レベル。

adapter
NetworkAdapter

StreamSocketListener オブジェクトをバインドするネットワーク アダプター。

戻り値

IAsyncAction

StreamSocketListener オブジェクトに対する非同期バインド操作。

属性
OverloadAttribute RemoteAsyncAttribute

注釈

[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) メソッドは、ローカル コンピューターのアダプター パラメーターで指定されたネットワーク アダプターの localServiceName パラメーターで指定されたローカル サービス名または TCP ポートにバインドします。 Bluetooth RFCOMM の場合、アダプター パラメーターが null の場合、このメソッドは localServiceName パラメーターで指定された Bluetooth サービス ID にバインドします。 Bluetooth 用にバインドするには、Bluetooth サービス ID を指定する必要があります。 ネットワーク アダプターが アダプター パラメーターで指定され、 localServiceName パラメーターに Bluetooth サービス ID が含まれている場合、このメソッドは失敗します。

このメソッドは、バインドされたソケットでの暗号化の保護レベルを protectionLevel パラメーターに設定します。

localServiceName パラメーターが空の文字列の場合、システムはバインドするローカル TCP ポートを選択します。 TCP ソケット バインドの アダプター パラメーターが null の 場合は、エラーが発生します。

[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) メソッドで使用される名前解決メカニズムは、ドメイン ネーム システム (DNS) 名前空間の指定されたインターフェイスに制限されます。

アダプター パラメーターで指定されたネットワーク アダプターの localServiceName パラメーターで指定されたローカル TCP ポートに別のアプリ (別の StreamSocketListener など) が既にバインドされている場合、[BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) メソッドは失敗します。 Bluetooth の場合、別のアプリ (別 の StreamSocketListener など) が localServiceName パラメーターで指定された Bluetooth サービス ID に既にバインドされている場合、このメソッドは失敗します。

指定したネットワーク アダプターの使用はベスト エフォートベースです。 弱ホストモードまたは転送モードで構成されたアダプターを持つシステムでは、指定されたアダプター以外のアダプターを使用できます。

Bluetooth 経由で使用されるソケットを除くすべてのソケットに対して、protectionLevel パラメーターを PlainSocket に設定する必要があります。 ソケットを Bluetooth 経由で使用する場合は、 protectionLevel パラメーターを PlainSocket、 BluetoothEncryptionAllowNullAuthentication、または BluetoothEncryptionWithAuthentication に設定できます。 詳細については、 SocketProtectionLevel 列挙を参照してください。

こちらもご覧ください

適用対象