StreamSocket.TransferOwnership Methode

Definition

Namespace:

Windows.Networking.Sockets

Ü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

OverloadAttribute

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)

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.

data

SocketActivityContext

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

OverloadAttribute

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)
• TransferOwnership(String, SocketActivityContext, TimeSpan)

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.

data

SocketActivityContext

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.

keepAliveTime

TimeSpan TimeSpan

Wie lange der Socketbrokerdienst den Socket auf Aktivität überwachen soll.

Attribute

OverloadAttribute

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)
• TransferOwnership(String, SocketActivityContext)