StreamSocket.EnableTransferOwnership Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction) |
Habilita o deshabilita la capacidad de que el agente de sockets desencadene la tarea en segundo plano de la aplicación cuando llega el tráfico para este StreamSocket mientras el sistema está en espera conectado. |
EnableTransferOwnership(Guid) |
Permite que el agente de sockets desencadene la tarea en segundo plano de la aplicación cuando llega el tráfico de este StreamSocket mientras la aplicación no está activa. |
EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)
Habilita o deshabilita la capacidad de que el agente de sockets desencadene la tarea en segundo plano de la aplicación cuando llega el tráfico para este StreamSocket mientras el sistema está en 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
IBackgroundTaskRegistration.TaskId de la tarea en segundo plano que se está habilitando o deshabilitando.
- connectedStandbyAction
- SocketActivityConnectedStandbyAction
Especifica si se va a habilitar o deshabilitar la activación de la tarea en segundo plano cuando llega el tráfico.
- Atributos
Comentarios
La causa más común de una excepción con un código de 0x80070490 y un mensaje de "Elemento no encontrado" es que el sistema no admite el modo de espera conectado. Para comprobarlo, llame a EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake)
. Si esa llamada alternativa se realiza correctamente sin iniciar una excepción, eso confirma que la excepción original se debe a que el sistema no está configurado para el modo de espera conectado. Y esa es una condición que el código tendrá que controlar.
El patrón de llamada de API que se recomienda es llamar EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake)
a . Si experimenta la excepción descrita anteriormente, vuelva a probar la llamada con SocketActivityConnectedStandbyAction.DoNotWake.
Consulte también
Se aplica a
EnableTransferOwnership(Guid)
Permite que el agente de sockets desencadene la tarea en segundo plano de la aplicación cuando llega el tráfico de este StreamSocket mientras la aplicación no está activa.
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
IBackgroundTaskRegistration.TaskId de la tarea en segundo plano que desencadenará el agente de sockets cuando llegue el tráfico para este StreamSocket.
- Atributos
Comentarios
Para obtener información sobre las condiciones de error, consulte la sección Comentarios de EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction).