StreamSocket.TransferOwnership Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| TransferOwnership(String) |
Überträgt den Besitz des StreamSocket an den Socketbrokerdienst, der die Socketaktivität überwacht und die App über eine Hintergrundaufgabe benachrichtigt, wenn Aktivität vorhanden ist. |
| TransferOwnership(String, SocketActivityContext) |
Überträgt den Besitz des StreamSocket an den Socketbrokerdienst, der die Socketaktivität überwacht und die App über eine Hintergrundaufgabe benachrichtigt, wenn Aktivität vorhanden ist. Gibt einen neuen SocketActivityContext für den Socket an. |
| TransferOwnership(String, SocketActivityContext, TimeSpan) |
Überträgt den Besitz des StreamSocket an den Socketbrokerdienst, der die Socketaktivität überwacht und die App über eine Hintergrundaufgabe benachrichtigt, wenn Aktivität vorhanden ist. Gibt einen neuen SocketActivityContext und eine Keep-Alive-Zeit für den Socket an. |
TransferOwnership(String)
Überträgt den Besitz des StreamSocket an den Socketbrokerdienst, der die Socketaktivität überwacht und die App über eine Hintergrundaufgabe benachrichtigt, wenn Aktivität vorhanden ist.
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)Parameter
- socketId
-
String
Platform::String
winrt::hstring
Eine Zeichenfolge, die die App verwendet, um den übertragenen Socket zu identifizieren. Die Zeichenfolge sollte diesen Socket innerhalb der App eindeutig identifizieren. Wenn Aktivität für diesen Socket auftritt, wird diese Zeichenfolge für die App bereitgestellt, um den Socket zu identifizieren.
- Attribute
Hinweise
Ihre App sollte diese Methode aufrufen, um den Besitz des StreamSocket an den Socketbrokerdienst zu übertragen, wenn die App angehalten wird, oder am Ende einer Hintergrundaufgabe. Ihre App sollte nach dem Aufrufen dieser Methode nicht auf das StreamSocket-Objekt zugreifen, es sei denn, sie reagiert auf Benachrichtigungen vom Socketbrokerdienst.
Hinweis
Dieser Aufruf schlägt fehl, wenn E/A-Vorgänge für streamSocket ausstehen. Ihr Code sollte StreamSocket.CancelIOAsync aufrufen, um jeden weiteren neuen Datenverkehr abzubrechen, und dann den gesamten ausstehenden Datenverkehr behandeln und dann SocketActivityContext aktualisieren, bevor StreamSocket.TransferOwnership aufgerufen wird.
Weitere Informationen
- TransferOwnership(String, SocketActivityContext)
- TransferOwnership(String, SocketActivityContext, TimeSpan)
Gilt für:
TransferOwnership(String, SocketActivityContext)
Überträgt den Besitz des StreamSocket an den Socketbrokerdienst, der die Socketaktivität überwacht und die App über eine Hintergrundaufgabe benachrichtigt, wenn Aktivität vorhanden ist. Gibt einen neuen SocketActivityContext für den Socket an.
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)Parameter
- socketId
-
String
Platform::String
winrt::hstring
Eine Zeichenfolge, die die App verwendet, um den übertragenen Socket zu identifizieren. Die Zeichenfolge sollte diesen Socket innerhalb der App eindeutig identifizieren. Wenn Aktivität für diesen Socket auftritt, wird diese Zeichenfolge für die App bereitgestellt, um den Socket zu identifizieren.
Verwenden Sie SocketActivityContext , um Kontextinformationen über den Socketbroker zu übergeben. Wenn Ihre App vom Broker der Aktivität benachrichtigt wird, wird dieser SocketActivityContext für Ihre App bereitgestellt, um den Kontext festzulegen, in dem Sie die Benachrichtigung behandeln sollten.
- Attribute
Hinweise
Ihre App sollte diese Methode aufrufen, um den Besitz des StreamSocket an den Socketbrokerdienst zu übertragen, wenn die App angehalten wird, oder am Ende einer Hintergrundaufgabe. Ihre App sollte nach dem Aufrufen dieser Methode nicht auf das StreamSocket-Objekt zugreifen, es sei denn, sie reagiert auf Benachrichtigungen vom Socketbrokerdienst.
Hinweis
Dieser Aufruf schlägt fehl, wenn E/A-Vorgänge für streamSocket ausstehen. Ihr Code sollte StreamSocket.CancelIOAsync aufrufen, um jeden weiteren neuen Datenverkehr abzubrechen, und dann den gesamten ausstehenden Datenverkehr behandeln und dann SocketActivityContext aktualisieren, bevor StreamSocket.TransferOwnership aufgerufen wird.
Weitere Informationen
Gilt für:
TransferOwnership(String, SocketActivityContext, TimeSpan)
Überträgt den Besitz des StreamSocket an den Socketbrokerdienst, der die Socketaktivität überwacht und die App über eine Hintergrundaufgabe benachrichtigt, wenn Aktivität vorhanden ist. Gibt einen neuen SocketActivityContext und eine Keep-Alive-Zeit für den Socket an.
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)Parameter
- socketId
-
String
Platform::String
winrt::hstring
Eine Zeichenfolge, die die App verwendet, um den übertragenen Socket zu identifizieren. Die Zeichenfolge sollte diesen Socket innerhalb der App eindeutig identifizieren. Wenn Aktivität für diesen Socket auftritt, wird diese Zeichenfolge für die App bereitgestellt, um den Socket zu identifizieren.
Verwenden Sie SocketActivityContext , um Kontextinformationen über den Socketbroker zu übergeben. Wenn Ihre App vom Broker der Aktivität benachrichtigt wird, wird dieser SocketActivityContext für Ihre App bereitgestellt, um den Kontext festzulegen, in dem Sie die Benachrichtigung behandeln sollten.
Wie lange der Socketbrokerdienst den Socket auf Aktivität überwachen soll.
- Attribute
Hinweise
Ihre App sollte diese Methode aufrufen, um den Besitz des StreamSocket an den Socketbrokerdienst zu übertragen, wenn die App angehalten wird, oder am Ende einer Hintergrundaufgabe. Ihre App sollte nach dem Aufrufen dieser Methode nicht auf das StreamSocket-Objekt zugreifen, es sei denn, sie reagiert auf Benachrichtigungen vom Socketbrokerdienst.
Hinweis
Dieser Aufruf schlägt fehl, wenn E/A-Vorgänge für streamSocket ausstehen. Ihr Code sollte StreamSocket.CancelIOAsync aufrufen, um jeden weiteren neuen Datenverkehr abzubrechen, und dann den gesamten ausstehenden Datenverkehr behandeln und dann SocketActivityContext aktualisieren, bevor StreamSocket.TransferOwnership aufgerufen wird.