語言

StreamSocket.TransferOwnership 方法

定義

多載

名稱 Description
TransferOwnership(String)

將 StreamSocket 的所有權轉移給 socket 經紀服務,該服務監控 socket 活動,並在有活動時透過背景任務通知應用程式。

TransferOwnership(String, SocketActivityContext)

將 StreamSocket 的所有權轉移給 socket 經紀服務,該服務監控 socket 活動,並在有活動時透過背景任務通知應用程式。 指定一個新的 SocketActivityContext 來指定該套接字。

TransferOwnership(String, SocketActivityContext, TimeSpan)

將 StreamSocket 的所有權轉移給 socket 經紀服務,該服務監控 socket 活動,並在有活動時透過背景任務通知應用程式。 指定一個新的 SocketActivityContext 以及該 socket 的保持存活時間。

TransferOwnership(String)

將 StreamSocket 的所有權轉移給 socket 經紀服務,該服務監控 socket 活動,並在有活動時透過背景任務通知應用程式。

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

應用程式用來識別轉移的套接字的字串。 這個字串應該能在應用程式內唯一識別這個 socket。 當該套接字發生活動時,該字串會提供給應用程式以識別該套接字。

屬性

備註

你的應用程式應該在應用程式即將被暫停或背景任務結束時,呼叫此方法將 StreamSocket 的所有權轉移給套接程式經紀服務。 你的應用程式在呼叫此方法後不應存取 StreamSocket 物件,除非在回應 socket 經紀服務的通知時。

備註

如果 StreamSocket 上有任何待處理的 I/O,這個呼叫就會失敗。 你的程式碼應該呼叫 StreamSocket.CancelIOAsync 來取消任何新的流量,接著處理所有待處理的流量,最後更新 SocketActivityContext,最後再呼叫 StreamSocket.TransferOwnership。

另請參閱

適用於

TransferOwnership(String, SocketActivityContext)

將 StreamSocket 的所有權轉移給 socket 經紀服務,該服務監控 socket 活動,並在有活動時透過背景任務通知應用程式。 指定一個新的 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

應用程式用來識別轉移的套接字的字串。 這個字串應該能在應用程式內唯一識別這個 socket。 當該套接字發生活動時,該字串會提供給應用程式以識別該套接字。

data
SocketActivityContext

使用 SocketActivityContext 將上下文資訊傳遞給 socket broker。 當你的應用程式收到活動經紀人通知時,這個 SocketActivityContext 會提供給你的應用程式,幫助你建立應該處理該通知的情境。

屬性

備註

你的應用程式應該在應用程式即將被暫停或背景任務結束時,呼叫此方法將 StreamSocket 的所有權轉移給套接程式經紀服務。 你的應用程式在呼叫此方法後不應存取 StreamSocket 物件,除非在回應 socket 經紀服務的通知時。

備註

如果 StreamSocket 上有任何待處理的 I/O,這個呼叫就會失敗。 你的程式碼應該呼叫 StreamSocket.CancelIOAsync 來取消任何新的流量,接著處理所有待處理的流量,最後更新 SocketActivityContext,最後再呼叫 StreamSocket.TransferOwnership。

另請參閱

適用於

TransferOwnership(String, SocketActivityContext, TimeSpan)

將 StreamSocket 的所有權轉移給 socket 經紀服務,該服務監控 socket 活動,並在有活動時透過背景任務通知應用程式。 指定一個新的 SocketActivityContext 以及該 socket 的保持存活時間。

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

應用程式用來識別轉移的套接字的字串。 這個字串應該能在應用程式內唯一識別這個 socket。 當該套接字發生活動時,該字串會提供給應用程式以識別該套接字。

data
SocketActivityContext

使用 SocketActivityContext 將上下文資訊傳遞給 socket broker。 當你的應用程式收到活動經紀人通知時,這個 SocketActivityContext 會提供給你的應用程式,幫助你建立應該處理該通知的情境。

keepAliveTime
TimeSpan TimeSpan

套接程式經紀服務應該監控套接字的活動多久?

屬性

備註

你的應用程式應該在應用程式即將被暫停或背景任務結束時,呼叫此方法將 StreamSocket 的所有權轉移給套接程式經紀服務。 你的應用程式在呼叫此方法後不應存取 StreamSocket 物件,除非在回應 socket 經紀服務的通知時。

備註

如果 StreamSocket 上有任何待處理的 I/O,這個呼叫就會失敗。 你的程式碼應該呼叫 StreamSocket.CancelIOAsync 來取消任何新的流量,接著處理所有待處理的流量,最後更新 SocketActivityContext,最後再呼叫 StreamSocket.TransferOwnership。

另請參閱

適用於