StreamSocket.EnableTransferOwnership Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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).