StreamSocket.EnableTransferOwnership Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction) |
Включает или отключает возможность активации фоновой задачи приложения брокером сокета, когда трафик для этого StreamSocket поступает, когда система находится в режиме ожидания подключения. |
EnableTransferOwnership(Guid) |
Позволяет активировать фоновую задачу вашего приложения брокером сокета, когда трафик для этого StreamSocket поступает, когда приложение неактивно. |
EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)
Включает или отключает возможность активации фоновой задачи приложения брокером сокета, когда трафик для этого StreamSocket поступает, когда система находится в режиме ожидания подключения.
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)
Параметры
- taskId
-
Guid
Platform::Guid
winrt::guid
IBackgroundTaskRegistration.TaskId фоновой задачи, включаемой или отключаемой.
- connectedStandbyAction
- SocketActivityConnectedStandbyAction
Указывает, следует ли включать или отключать активацию фоновой задачи при поступлении трафика.
- Атрибуты
Комментарии
Наиболее распространенная причина исключения с кодом 0x80070490 и сообщением "Элемент не найден" заключается в том, что система не поддерживает подключенный резервный режим. Это можно проверить, вызвав .EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake)
Если этот альтернативный вызов завершается успешно, не создавая исключение, это подтверждает, что исходное исключение вызвано тем, что система не настроена для режима ожидания подключения. И это условие, которое код должен будет обрабатывать.
Мы рекомендуем использовать шаблон вызова API для вызова EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake)
. Если возникает исключение, описанное выше, повторите вызов с помощью SocketActivityConnectedStandbyAction.DoNotWake.
См. также раздел
Применяется к
EnableTransferOwnership(Guid)
Позволяет активировать фоновую задачу вашего приложения брокером сокета, когда трафик для этого StreamSocket поступает, когда приложение неактивно.
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)
Параметры
- taskId
-
Guid
Platform::Guid
winrt::guid
IBackgroundTaskRegistration.TaskId фоновой задачи, которая будет активирована брокером сокета при поступлении трафика для этого StreamSocket.
- Атрибуты
Комментарии
Сведения об ошибках см. в разделе Примечания для EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction).