Condividi tramite

StreamSocketListener.BindServiceNameAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Networking.Sockets

Overload

BindServiceNameAsync(String)

Avvia un'operazione di associazione in un oggetto StreamSocketListener in un nome del servizio locale.
BindServiceNameAsync(String, SocketProtectionLevel)

Avvia un'operazione di associazione in un oggetto StreamSocketListener su un nome del servizio locale con un socketProtectionLevel specificato da impostare su qualsiasi socket associato.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Avvia un'operazione di associazione socket in un oggetto StreamSocketListener in un nome di servizio locale in una scheda di rete specificata con socketProtectionLevel specificato da impostare su qualsiasi socket associato.

BindServiceNameAsync(String)

Modifica

Avvia un'operazione di associazione in un oggetto StreamSocketListener in un nome del servizio locale.

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

Parametri

localServiceName
String

Platform::String

winrt::hstring

Nome del servizio locale o porta TCP in cui associare l'oggetto StreamSocketListener . Per Bluetooth RFCOMM, questo parametro è l'ID del servizio Bluetooth.

Restituisce

IAsyncAction

Operazione di associazione asincrona in un oggetto StreamSocketListener .

Attributi
RemoteAsyncAttribute

Commenti

Il metodo BindServiceNameAsync(String) associa agli indirizzi IP locali di tutte le interfacce di rete nel computer locale e al nome del servizio locale o alla porta TCP specificata nel parametro localServiceName . Se il parametro localServiceName è una stringa vuota, il sistema selezionerà la porta TCP locale in cui eseguire l'associazione.

Per Bluetooth RFCOMM, questo metodo viene associato all'ID del servizio Bluetooth specificato nel parametro localServiceName in tutte le interfacce Bluetooth. Un ID servizio Bluetooth deve essere fornito per l'associazione per Bluetooth.

Il metodo BindServiceNameAsync(String) avrà esito negativo se un'altra app (un'altra app StreamSocketListener, ad esempio) è già stata associata alla porta TCP locale o all'ID del servizio Bluetooth specificato nel parametro localServiceName .

Vedi anche

Si applica a

BindServiceNameAsync(String, SocketProtectionLevel)

Modifica

Avvia un'operazione di associazione in un oggetto StreamSocketListener su un nome del servizio locale con un socketProtectionLevel specificato da impostare su qualsiasi socket associato.

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

Parametri

localServiceName
String

Platform::String

winrt::hstring

Nome del servizio locale o porta TCP in cui associare l'oggetto StreamSocketListener . Per Bluetooth RFCOMM, questo parametro è l'ID del servizio Bluetooth.

protectionLevel
SocketProtectionLevel

Livello di protezione per la crittografia da impostare su qualsiasi socket associato.

Restituisce

IAsyncAction

Operazione di associazione asincrona in un oggetto StreamSocketListener .

Attributi
OverloadAttribute RemoteAsyncAttribute

Commenti

Il metodo [BindServiceNameAsync(String, SocketProtectionLevel) associa agli indirizzi IP locali di tutte le interfacce di rete nel computer locale e al nome del servizio locale o alla porta TCP specificata nel parametro localServiceName . Per Bluetooth RFCOMM, questo metodo viene associato all'ID del servizio Bluetooth specificato nel parametro localServiceName in tutte le interfacce Bluetooth. Questo metodo imposta il livello di protezione per la crittografia in qualsiasi socket associato al parametro protectionLevel .

Se il parametro localServiceName è una stringa vuota, il sistema selezionerà la porta TCP locale in cui eseguire l'associazione. Un ID servizio Bluetooth deve essere fornito per l'associazione per Bluetooth.

Il metodo [BindServiceNameAsync(String, SocketProtectionLevel) avrà esito negativo se un'altra app (un'altra streamSocketListener, ad esempio) è già stata associata alla porta TCP locale o all'ID del servizio Bluetooth specificato nel parametro localServiceName .

Il parametro protectionLevel deve essere impostato su PlainSocket per tutti i socket, ad eccezione di quelli usati tramite Bluetooth. Quando il socket deve essere usato tramite Bluetooth, il parametro protectionLevel può essere impostato su PlainSocket, BluetoothEncryptionAllowNullAuthentication o BluetoothEncryptionWithAuthentication. Per altre informazioni, vedere l'enumerazione SocketProtectionLevel .

Vedi anche

Si applica a

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Modifica

Avvia un'operazione di associazione socket in un oggetto StreamSocketListener in un nome di servizio locale in una scheda di rete specificata con socketProtectionLevel specificato da impostare su qualsiasi socket associato.

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

Parametri

localServiceName
String

Platform::String

winrt::hstring

Nome del servizio locale o porta TCP in cui associare l'oggetto StreamSocketListener . Per Bluetooth RFCOMM, questo parametro è l'ID del servizio Bluetooth.

protectionLevel
SocketProtectionLevel

Livello di protezione per la crittografia da impostare su qualsiasi socket associato.

adapter
NetworkAdapter

Scheda di rete in cui associare l'oggetto StreamSocketListener .

Restituisce

IAsyncAction

Operazione di associazione asincrona in un oggetto StreamSocketListener .

Attributi
OverloadAttribute RemoteAsyncAttribute

Commenti

Il metodo [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) viene associato al nome del servizio locale o alla porta TCP specificata nel parametro localServiceName nella scheda di rete specificata nel parametro adapter nel computer locale. Per Bluetooth RFCOMM, questo metodo viene associato all'ID del servizio Bluetooth specificato nel parametro localServiceName se il parametro adapter è Null. Un ID servizio Bluetooth deve essere fornito per l'associazione per Bluetooth. Se viene specificata una scheda di rete nel parametro adapter e il parametro localServiceName contiene un ID servizio Bluetooth, questo metodo avrà esito negativo.

Questo metodo imposta il livello di protezione per la crittografia in qualsiasi socket associato al parametro protectionLevel .

Se il parametro localServiceName è una stringa vuota, il sistema selezionerà la porta TCP locale in cui eseguire l'associazione. Se il parametro dell'adattatore è Null per un binding socket TCP, si verificherà un errore.

Il meccanismo di risoluzione dei nomi utilizzato dal metodo [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) è limitato all'interfaccia specificata per lo spazio dei nomi DNS (Domain Name System).

Il metodo [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) avrà esito negativo se un'altra app (un'altra app StreamSocketListener, ad esempio) è già stata associata alla porta TCP locale specificata nel parametrolocalServiceName nella scheda di rete specificata nel parametro adapter. Per Bluetooth, questo metodo avrà esito negativo se un'altra app (un'altra app StreamSocketListener, ad esempio) è già stata associata all'ID del servizio Bluetooth specificato nel parametro localServiceName .

L'uso della scheda di rete specificata è su base ottimale. Un sistema con adattatori configurati in modalità di inoltro o host debole può usare un adattatore diverso dall'adattatore specificato.

Il parametro protectionLevel deve essere impostato su PlainSocket per tutti i socket, ad eccezione di quelli usati tramite Bluetooth. Quando il socket deve essere usato tramite Bluetooth, il parametro protectionLevel può essere impostato su PlainSocket, BluetoothEncryptionAllowNullAuthentication o BluetoothEncryptionWithAuthentication. Per altre informazioni, vedere l'enumerazione SocketProtectionLevel .

Vedi anche

Si applica a