StreamSocket.EnableTransferOwnership Methode

Definition

Namespace:

Windows.Networking.Sockets

Überlädt

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)	Aktiviert oder deaktiviert die Möglichkeit der Hintergrundaufgabe Ihrer App, vom Socketbroker ausgelöst zu werden, wenn der Datenverkehr für dieses StreamSocket eingeht, während sich das System im verbundenen Standbymodus befindet.
EnableTransferOwnership(Guid)	Ermöglicht, dass die Hintergrundaufgabe Ihrer App vom Socketbroker ausgelöst wird, wenn datenverkehr für dieses StreamSocket eingeht, während die App nicht aktiv ist.

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

Aktiviert oder deaktiviert die Möglichkeit der Hintergrundaufgabe Ihrer App, vom Socketbroker ausgelöst zu werden, wenn der Datenverkehr für dieses StreamSocket eingeht, während sich das System im verbundenen Standbymodus befindet.

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)

Parameter

taskId

Guid

Platform::Guid

winrt::guid

Die IBackgroundTaskRegistration.TaskId der Hintergrundaufgabe, die aktiviert oder deaktiviert wird.

connectedStandbyAction

SocketActivityConnectedStandbyAction

Gibt an, ob die Aktivierung der Hintergrundaufgabe beim Eintreffen des Datenverkehrs aktiviert oder deaktiviert werden soll.

Attribute

OverloadAttribute

Hinweise

Die häufigste Ursache für eine Ausnahme mit einem Code mit 0x80070490 und der Meldung "Element nicht gefunden" ist, dass Ihr System den verbundenen Standbymodus nicht unterstützt. Sie können dies überprüfen, indem Sie aufrufen EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake). Wenn dieser alternative Aufruf ohne Auslösen einer Ausnahme erfolgreich ist, wird bestätigt, dass die ursprüngliche Ausnahme dadurch verursacht wird, dass das System nicht für den verbundenen Standbymodus eingerichtet wurde. Und das ist eine Bedingung, die Ihr Code behandeln muss.

Das API-Aufrufmuster, das wir empfehlen, ist das Aufrufen EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake)von . Wenn die oben beschriebene Ausnahme auftritt, probieren Sie den Aufruf mit SocketActivityConnectedStandbyAction.DoNotWake erneut aus.

Weitere Informationen

• EnableTransferOwnership(Guid)

EnableTransferOwnership(Guid)

Ermöglicht, dass die Hintergrundaufgabe Ihrer App vom Socketbroker ausgelöst wird, wenn datenverkehr für dieses StreamSocket eingeht, während die App nicht aktiv ist.

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)

Parameter

taskId

Guid

Platform::Guid

winrt::guid

Die IBackgroundTaskRegistration.TaskId der Hintergrundaufgabe, die vom Socketbroker ausgelöst wird, wenn Datenverkehr für dieses StreamSocket eingeht.

Attribute

OverloadAttribute

Hinweise

Informationen zu Fehlerbedingungen finden Sie im Abschnitt Hinweise zu EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction).

Weitere Informationen

• EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)