Freigeben über


StreamSocket.EnableTransferOwnership Methode

Definition

Ü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

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

Gilt für:

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

Hinweise

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

Weitere Informationen

Gilt für: