StreamSocket.EnableTransferOwnership Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction) |
Habilita ou desabilita a capacidade da tarefa em segundo plano do aplicativo ser disparada pelo agente de soquete quando o tráfego para esse StreamSocket chega enquanto o sistema está em espera conectado. |
| EnableTransferOwnership(Guid) |
Permite que a tarefa em segundo plano do aplicativo seja disparada pelo agente de soquete quando o tráfego para esse StreamSocket chegar enquanto o aplicativo não estiver ativo. |
EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)
Habilita ou desabilita a capacidade da tarefa em segundo plano do aplicativo ser disparada pelo agente de soquete quando o tráfego para esse StreamSocket chega enquanto o sistema está em espera conectado.
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)Parâmetros
- taskId
-
Guid
Platform::Guid
winrt::guid
O IBackgroundTaskRegistration.TaskId da tarefa em segundo plano que está sendo habilitada ou desabilitada.
- connectedStandbyAction
- SocketActivityConnectedStandbyAction
Especifica se deseja habilitar ou desabilitar a ativação da tarefa em segundo plano quando o tráfego chegar.
- Atributos
Comentários
A causa mais comum de uma exceção com um código de 0x80070490 e uma mensagem de "Elemento não encontrado" é que seu sistema não dá suporte ao modo de espera conectado. Você pode verificar isso chamando EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake). Se essa chamada alternativa for bem-sucedida sem gerar uma exceção, isso confirmará que a exceção original é causada pelo sistema que não está sendo configurado para espera conectada. E essa é uma condição que seu código precisará lidar.
O padrão de chamada de API que recomendamos é chamar EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake). Se você tiver a exceção descrita acima, tente novamente a chamada com SocketActivityConnectedStandbyAction.DoNotWake.
Confira também
Aplica-se a
EnableTransferOwnership(Guid)
Permite que a tarefa em segundo plano do aplicativo seja disparada pelo agente de soquete quando o tráfego para esse StreamSocket chegar enquanto o aplicativo não estiver ativo.
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)Parâmetros
- taskId
-
Guid
Platform::Guid
winrt::guid
O IBackgroundTaskRegistration.TaskId da tarefa em segundo plano que será disparada pelo agente de soquete quando o tráfego chegar para esse StreamSocket.
- Atributos
Comentários
Para obter informações sobre condições de erro, consulte a seção Comentários de EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction).