StreamSocket.EnableTransferOwnership 메서드

정의

오버로드

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

시스템이 연결된 대기 상태일 때 이 StreamSocket 에 대한 트래픽이 도착할 때 소켓 브로커에 의해 트리거되는 앱의 백그라운드 작업의 기능을 사용하거나 사용하지 않도록 설정합니다.

EnableTransferOwnership(Guid)

앱이 활성 상태가 아닌 동안 이 StreamSocket 에 대한 트래픽이 도착하면 소켓 브로커에 의해 앱의 백그라운드 작업을 트리거할 수 있습니다.

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

시스템이 연결된 대기 상태일 때 이 StreamSocket 에 대한 트래픽이 도착할 때 소켓 브로커에 의해 트리거되는 앱의 백그라운드 작업의 기능을 사용하거나 사용하지 않도록 설정합니다.

public:
 virtual void EnableTransferOwnership(Platform::Guid taskId, SocketActivityConnectedStandbyAction connectedStandbyAction) = EnableTransferOwnership;
/// [Windows.Foundation.Metadata.Overload("EnableTransferOwnershipWithConnectedStandbyAction")]
void EnableTransferOwnership(winrt::guid const& taskId, SocketActivityConnectedStandbyAction const& connectedStandbyAction);
[Windows.Foundation.Metadata.Overload("EnableTransferOwnershipWithConnectedStandbyAction")]
public void EnableTransferOwnership(Guid taskId, SocketActivityConnectedStandbyAction connectedStandbyAction);
function enableTransferOwnership(taskId, connectedStandbyAction)
Public Sub EnableTransferOwnership (taskId As Guid, connectedStandbyAction As SocketActivityConnectedStandbyAction)

매개 변수

taskId
Guid

Platform::Guid

winrt::guid

사용하거나 사용하지 않도록 설정 중인 백그라운드 작업의 IBackgroundTaskRegistration.TaskId 입니다.

connectedStandbyAction
SocketActivityConnectedStandbyAction

트래픽이 도착할 때 백그라운드 작업의 활성화를 사용하거나 사용하지 않도록 설정할지 여부를 지정합니다.

특성

설명

0x80070490 코드와 "요소를 찾을 수 없음"이라는 메시지가 있는 예외의 가장 일반적인 원인은 시스템에서 연결된 대기를 지원하지 않는다는 것입니다. 를 호출 EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake)하여 확인할 수 있습니다. 예외를 throw하지 않고 대체 호출이 성공하면 시스템이 연결된 대기에 대해 설정되지 않아 원래 예외가 발생했음을 확인합니다. 코드에서 처리해야 하는 조건입니다.

권장되는 API 호출 패턴은 를 호출 EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake)하는 것입니다. 위에서 설명한 예외가 발생하면 SocketActivityConnectedStandbyAction.DoNotWake를 사용하여 호출을 다시 시도합니다.

추가 정보

적용 대상

EnableTransferOwnership(Guid)

앱이 활성 상태가 아닌 동안 이 StreamSocket 에 대한 트래픽이 도착하면 소켓 브로커에 의해 앱의 백그라운드 작업을 트리거할 수 있습니다.

public:
 virtual void EnableTransferOwnership(Platform::Guid taskId) = EnableTransferOwnership;
/// [Windows.Foundation.Metadata.Overload("EnableTransferOwnership")]
void EnableTransferOwnership(winrt::guid const& taskId);
[Windows.Foundation.Metadata.Overload("EnableTransferOwnership")]
public void EnableTransferOwnership(Guid taskId);
function enableTransferOwnership(taskId)
Public Sub EnableTransferOwnership (taskId As Guid)

매개 변수

taskId
Guid

Platform::Guid

winrt::guid

StreamSocket에 대한 트래픽이 도착할 때 소켓 브로커에 의해 트리거되는 백그라운드 작업의 IBackgroundTaskRegistration.TaskId입니다.

특성

설명

오류 조건에 대한 자세한 내용은 EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)에 대한 설명 섹션을 참조하세요.

추가 정보

적용 대상