Sprache

StreamSocket.EnableTransferOwnership Methode

Definition

Überlädt

Name Beschreibung
EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

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

EnableTransferOwnership(Guid)

Ermöglicht es der Hintergrundaufgabe Ihrer App, vom Socketbroker ausgelöst zu werden, 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 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 aktiviert oder deaktiviert werden soll, wenn der Datenverkehr eingeht.

Attribute

Hinweise

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

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

Siehe auch

Gilt für:

EnableTransferOwnership(Guid)

Ermöglicht es der Hintergrundaufgabe Ihrer App, vom Socketbroker ausgelöst zu werden, 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

Hinweise

Informationen zu Fehlerbedingungen finden Sie im Abschnitt "Hinweise " für EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction).

Siehe auch

Gilt für: