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 オブジェクトにアクセスしないでください。

Note

StreamSocket に保留中の I/O がある場合、この呼び出しは失敗します。 コードで StreamSocket.CancelIOAsync を呼び出して、それ以上の新しいトラフィックを取り消し、保留中のすべてのトラフィックを処理してから、StreamSocket.TransferOwnership を呼び出す前に SocketActivityContext を更新する必要があります。

こちらもご覧ください

• 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 オブジェクトにアクセスしないでください。

Note

StreamSocket に保留中の I/O がある場合、この呼び出しは失敗します。 コードで StreamSocket.CancelIOAsync を呼び出して、それ以上の新しいトラフィックを取り消し、保留中のすべてのトラフィックを処理してから、StreamSocket.TransferOwnership を呼び出す前に SocketActivityContext を更新する必要があります。

こちらもご覧ください

• 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 オブジェクトにアクセスしないでください。

Note

StreamSocket に保留中の I/O がある場合、この呼び出しは失敗します。 コードで StreamSocket.CancelIOAsync を呼び出して、それ以上の新しいトラフィックを取り消し、保留中のすべてのトラフィックを処理してから、StreamSocket.TransferOwnership を呼び出す前に SocketActivityContext を更新する必要があります。

こちらもご覧ください

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