StreamSocket.TransferOwnership Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
TransferOwnership(String) |
Передает право владения StreamSocket службе брокера сокетов, которая отслеживает активность сокетов и уведомляет приложение с помощью фоновой задачи, если есть какие-либо действия. |
TransferOwnership(String, SocketActivityContext) |
Передает право владения StreamSocket службе брокера сокетов, которая отслеживает активность сокетов и уведомляет приложение с помощью фоновой задачи, если есть какие-либо действия. Указывает новый socketActivityContext для сокета. |
TransferOwnership(String, SocketActivityContext, TimeSpan) |
Передает право владения StreamSocket службе брокера сокетов, которая отслеживает активность сокетов и уведомляет приложение с помощью фоновой задачи, если есть какие-либо действия. Указывает новый socketActivityContext и время активности сокета. |
TransferOwnership(String)
Передает право владения StreamSocket службе брокера сокетов, которая отслеживает активность сокетов и уведомляет приложение с помощью фоновой задачи, если есть какие-либо действия.
public:
virtual void TransferOwnership(Platform::String ^ socketId) = TransferOwnership;
/// [Windows.Foundation.Metadata.Overload("TransferOwnership")]
void TransferOwnership(winrt::hstring const& socketId);
[Windows.Foundation.Metadata.Overload("TransferOwnership")]
public void TransferOwnership(string socketId);
function transferOwnership(socketId)
Public Sub TransferOwnership (socketId As String)
Параметры
- socketId
-
String
Platform::String
winrt::hstring
Строка, которая используется приложением для идентификации переданного сокета. Строка должна однозначно идентифицировать этот сокет в приложении. При выполнении действия в этом сокете эта строка будет предоставлена приложению для идентификации сокета.
- Атрибуты
Комментарии
Приложение должно вызывать этот метод для передачи права владения StreamSocket службе брокера сокетов, когда приложение будет приостановлено или в конце фоновой задачи. Ваше приложение не должно обращаться к объекту StreamSocket после вызова этого метода, за исключением случаев, когда он отвечает на уведомления от службы брокера сокетов.
Примечание
Этот вызов завершается ошибкой при наличии ожидающих операций ввода-вывода в StreamSocket. Код должен вызвать StreamSocket.CancelIOAsync , чтобы отменить дальнейший новый трафик, а затем обработать весь ожидающий трафик, а затем обновить SocketActivityContext перед вызовом StreamSocket.TransferOwnership.
См. также раздел
- TransferOwnership(String, SocketActivityContext)
- TransferOwnership(String, SocketActivityContext, TimeSpan)
Применяется к
TransferOwnership(String, SocketActivityContext)
Передает право владения StreamSocket службе брокера сокетов, которая отслеживает активность сокетов и уведомляет приложение с помощью фоновой задачи, если есть какие-либо действия. Указывает новый socketActivityContext для сокета.
public:
virtual void TransferOwnership(Platform::String ^ socketId, SocketActivityContext ^ data) = TransferOwnership;
/// [Windows.Foundation.Metadata.Overload("TransferOwnershipWithContext")]
void TransferOwnership(winrt::hstring const& socketId, SocketActivityContext const& data);
[Windows.Foundation.Metadata.Overload("TransferOwnershipWithContext")]
public void TransferOwnership(string socketId, SocketActivityContext data);
function transferOwnership(socketId, data)
Public Sub TransferOwnership (socketId As String, data As SocketActivityContext)
Параметры
- socketId
-
String
Platform::String
winrt::hstring
Строка, которая используется приложением для идентификации переданного сокета. Строка должна однозначно идентифицировать этот сокет в приложении. При выполнении действия в этом сокете эта строка будет предоставлена приложению для идентификации сокета.
Используйте SocketActivityContext для передачи сведений о контексте через брокер сокетов. Когда брокер уведомляет ваше приложение о действиях, этот SocketActivityContext будет предоставлен вашему приложению, чтобы помочь установить контекст, в котором следует обрабатывать уведомление.
- Атрибуты
Комментарии
Приложение должно вызывать этот метод для передачи права владения StreamSocket службе брокера сокетов, когда приложение будет приостановлено или в конце фоновой задачи. Ваше приложение не должно обращаться к объекту StreamSocket после вызова этого метода, за исключением случаев, когда он отвечает на уведомления от службы брокера сокетов.
Примечание
Этот вызов завершается ошибкой при наличии ожидающих операций ввода-вывода в StreamSocket. Код должен вызвать StreamSocket.CancelIOAsync , чтобы отменить дальнейший новый трафик, а затем обработать весь ожидающий трафик, а затем обновить SocketActivityContext перед вызовом StreamSocket.TransferOwnership.
См. также раздел
Применяется к
TransferOwnership(String, SocketActivityContext, TimeSpan)
Передает право владения StreamSocket службе брокера сокетов, которая отслеживает активность сокетов и уведомляет приложение с помощью фоновой задачи, если есть какие-либо действия. Указывает новый socketActivityContext и время активности сокета.
public:
virtual void TransferOwnership(Platform::String ^ socketId, SocketActivityContext ^ data, TimeSpan keepAliveTime) = TransferOwnership;
/// [Windows.Foundation.Metadata.Overload("TransferOwnershipWithContextAndKeepAliveTime")]
void TransferOwnership(winrt::hstring const& socketId, SocketActivityContext const& data, TimeSpan const& keepAliveTime);
[Windows.Foundation.Metadata.Overload("TransferOwnershipWithContextAndKeepAliveTime")]
public void TransferOwnership(string socketId, SocketActivityContext data, System.TimeSpan keepAliveTime);
function transferOwnership(socketId, data, keepAliveTime)
Public Sub TransferOwnership (socketId As String, data As SocketActivityContext, keepAliveTime As TimeSpan)
Параметры
- socketId
-
String
Platform::String
winrt::hstring
Строка, которая используется приложением для идентификации переданного сокета. Строка должна однозначно идентифицировать этот сокет в приложении. При выполнении действия в этом сокете эта строка будет предоставлена приложению для идентификации сокета.
Используйте SocketActivityContext для передачи сведений о контексте через брокер сокетов. Когда брокер уведомляет ваше приложение о действиях, этот SocketActivityContext будет предоставлен вашему приложению, чтобы помочь установить контекст, в котором следует обрабатывать уведомление.
Как долго служба брокера сокетов должна отслеживать сокет на наличие активности.
- Атрибуты
Комментарии
Приложение должно вызывать этот метод для передачи права владения StreamSocket службе брокера сокетов, когда приложение будет приостановлено или в конце фоновой задачи. Ваше приложение не должно обращаться к объекту StreamSocket после вызова этого метода, за исключением случаев, когда он отвечает на уведомления от службы брокера сокетов.
Примечание
Этот вызов завершается ошибкой при наличии ожидающих операций ввода-вывода в StreamSocket. Код должен вызвать StreamSocket.CancelIOAsync , чтобы отменить дальнейший новый трафик, а затем обработать весь ожидающий трафик, а затем обновить SocketActivityContext перед вызовом StreamSocket.TransferOwnership.