StreamSocket.EnableTransferOwnership メソッド

定義

名前空間:

Windows.Networking.Sockets

オーバーロード

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

トラフィックが到着したときにバックグラウンド タスクのアクティブ化を有効または無効にするかどうかを指定します。

属性

OverloadAttribute

注釈

0x80070490のコードで例外が発生し、"要素が見つかりません" というメッセージが表示される最も一般的な原因は、システムがコネクト スタンバイをサポートしていないことです。 これを確認するには、 を呼び出します EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake)。 その代替呼び出しが例外をスローせずに成功した場合は、システムがコネクト スタンバイ用に設定されていないことが原因で元の例外が発生していることを確認します。 これは、コードで処理する必要がある条件です。

推奨される API 呼び出しパターンは、 を呼び出すこと EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake)です。 上記の例外が発生した場合は、 SocketActivityConnectedStandbyAction.DoNotWake を使用して呼び出しを再試行してください。

こちらもご覧ください

• EnableTransferOwnership(Guid)

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。

属性

OverloadAttribute

注釈

エラー条件の詳細については、「EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)」の「解説」セクションを参照してください。

こちらもご覧ください

• EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)