StreamSocket.TransferOwnership 方法

定義

命名空間:

Windows.Networking.Sockets

多載

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

應用程式用來識別傳輸通訊端的字串。 字串應該會在應用程式內唯一識別此通訊端。 當此通訊端上發生活動時，此字串會提供給應用程式以識別通訊端。

屬性

OverloadAttribute

備註

當應用程式即將暫停或背景工作結束時，您的應用程式應該呼叫這個方法，將 StreamSocket 的擁有權轉移至通訊端代理服務。 您的應用程式在呼叫此方法之後不應該存取 StreamSocket 物件，除非回應來自通訊端代理服務的通知。

注意

如果 StreamSocket上有任何擱置的 I/O，此呼叫就會失敗。 您的程式碼應該呼叫 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

應用程式用來識別傳輸通訊端的字串。 字串應該會在應用程式內唯一識別此通訊端。 當此通訊端上發生活動時，此字串會提供給應用程式以識別通訊端。

data

SocketActivityContext

使用 SocketActivityCoNtext 透過通訊端代理程式傳遞內容資訊。 當活動代理程式收到代理程式更新時，系統會將這個 SocketActivityCoNtext 提供給您的應用程式，以協助建立您應該處理通知的內容。

屬性

OverloadAttribute

備註

當應用程式即將暫停或背景工作結束時，您的應用程式應該呼叫這個方法，將 StreamSocket 的擁有權轉移至通訊端代理服務。 您的應用程式在呼叫此方法之後不應該存取 StreamSocket 物件，除非回應來自通訊端代理服務的通知。

注意

如果 StreamSocket上有任何擱置的 I/O，此呼叫就會失敗。 您的程式碼應該呼叫 StreamSocket.CancelIOAsync 來取消任何進一步的新流量，然後處理所有擱置中的流量，然後更新 SocketActivityCoNtext，再呼叫 StreamSocket.TransferOwnership。

另請參閱

• TransferOwnership(String)
• TransferOwnership(String, SocketActivityContext, TimeSpan)

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

應用程式用來識別傳輸通訊端的字串。 字串應該會在應用程式內唯一識別此通訊端。 當此通訊端上發生活動時，此字串會提供給應用程式以識別通訊端。

data

SocketActivityContext

使用 SocketActivityCoNtext 透過通訊端代理程式傳遞內容資訊。 當活動代理程式收到代理程式更新時，系統會將這個 SocketActivityCoNtext 提供給您的應用程式，以協助建立您應該處理通知的內容。

keepAliveTime

TimeSpan TimeSpan

通訊端代理服務應該監視通訊端活動的時間長度。

屬性

OverloadAttribute

備註

當應用程式即將暫停或背景工作結束時，您的應用程式應該呼叫這個方法，將 StreamSocket 的擁有權轉移至通訊端代理服務。 您的應用程式在呼叫此方法之後不應該存取 StreamSocket 物件，除非回應來自通訊端代理服務的通知。

注意

如果 StreamSocket上有任何擱置的 I/O，此呼叫就會失敗。 您的程式碼應該呼叫 StreamSocket.CancelIOAsync 來取消任何進一步的新流量，然後處理所有擱置中的流量，然後更新 SocketActivityCoNtext，再呼叫 StreamSocket.TransferOwnership。

另請參閱

• TransferOwnership(String)
• TransferOwnership(String, SocketActivityContext)