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

備註

For info about error conditions, see the Remarks section for EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction).

另請參閱

• EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)