共用方式為


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) 來驗證 。 如果該替代呼叫成功而不擲回例外狀況,則確認原始例外狀況是由系統未設定連線待命所造成。 這是程式碼需要處理的條件。

我們建議的 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

屬性

備註

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

另請參閱

適用於