StreamSocketListener.BindServiceNameAsync 메서드

참조

정의

네임스페이스:: Windows.Networking.Sockets

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

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를 제공해야 합니다.

다른 앱(예: 다른 StreamSocketListener)이 localServiceName 매개 변수에 지정된 로컬 TCP 포트 또는 Bluetooth 서비스 ID에 이미 바인딩된 경우 [BindServiceNameAsync(String, SocketProtectionLevel) 메서드가 실패합니다.

ProtectionLevel 매개 변수는 Bluetooth를 통해 사용되는 소켓을 제외한 모든 소켓에 대해 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(도메인 이름 시스템) 네임스페이스에 대해 지정된 인터페이스로 제한됩니다.

다른 앱(예: 다른 StreamSocketListener)이 어댑터 매개 변수에 지정된 네트워크 어댑터의 localServiceName 매개 변수에 지정된 로컬 TCP 포트에 이미 바인딩된 경우 [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) 메서드가 실패합니다. Bluetooth의 경우 다른 앱(예: 다른 StreamSocketListener)이 localServiceName 매개 변수에 지정된 Bluetooth 서비스 ID에 이미 바인딩된 경우 이 메서드는 실패합니다.

지정된 네트워크 어댑터를 사용하는 것이 가장 좋습니다. 어댑터가 약한 호스트 또는 전달 모드로 구성된 시스템은 지정된 어댑터 이외의 어댑터를 사용할 수 있습니다.

추가 정보

적용 대상

StreamSocketListener.BindServiceNameAsync 메서드

정의

오버로드

BindServiceNameAsync(String)

매개 변수

반환

설명

추가 정보

적용 대상

BindServiceNameAsync(String, SocketProtectionLevel)

매개 변수

반환

설명

추가 정보

적용 대상

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

매개 변수

반환

설명

추가 정보

적용 대상

피드백

피드백

추가 리소스