StreamSocket.EnableTransferOwnership Méthode

Définition

Surcharges

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

Active ou désactive la capacité de la tâche en arrière-plan de votre application à être déclenchée par le répartiteur de sockets lorsque le trafic pour ce StreamSocket arrive alors que le système est en veille connectée.

EnableTransferOwnership(Guid)

Permet à la tâche en arrière-plan de votre application d’être déclenchée par le répartiteur de sockets lorsque le trafic de ce StreamSocket arrive alors que l’application n’est pas active.

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

Active ou désactive la capacité de la tâche en arrière-plan de votre application à être déclenchée par le répartiteur de sockets lorsque le trafic pour ce StreamSocket arrive alors que le système est en veille connectée.

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)

Paramètres

taskId
Guid

Platform::Guid

winrt::guid

IBackgroundTaskRegistration.TaskId de la tâche en arrière-plan activée ou désactivée.

connectedStandbyAction
SocketActivityConnectedStandbyAction

Spécifie s’il faut activer ou désactiver l’activation de la tâche en arrière-plan lorsque le trafic arrive.

Attributs

Remarques

La cause la plus courante d’une exception avec un code de 0x80070490 et un message « Élément introuvable » est que votre système ne prend pas en charge la veille connectée. Vous pouvez le vérifier en appelant EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake). Si cet autre appel réussit sans lever d’exception, cela confirme que l’exception d’origine est due au fait que le système n’est pas configuré pour la veille connectée. Il s’agit d’une condition que votre code devra gérer.

Le modèle d’appel d’API que nous vous recommandons est d’appeler EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake). Si vous rencontrez l’exception décrite ci-dessus, réessayez l’appel avec SocketActivityConnectedStandbyAction.DoNotWake.

Voir aussi

S’applique à

EnableTransferOwnership(Guid)

Permet à la tâche en arrière-plan de votre application d’être déclenchée par le répartiteur de sockets lorsque le trafic de ce StreamSocket arrive alors que l’application n’est pas active.

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)

Paramètres

taskId
Guid

Platform::Guid

winrt::guid

IBackgroundTaskRegistration.TaskId de la tâche en arrière-plan qui sera déclenchée par le répartiteur de sockets lorsque le trafic arrive pour ce StreamSocket.

Attributs

Remarques

Pour plus d’informations sur les conditions d’erreur, consultez la section Notes pour EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction) .

Voir aussi

S’applique à