StreamSocket.CancelIOAsync メソッド

定義

名前空間:

Windows.Networking.Sockets

StreamSocket オブジェクトに対する保留中の読み取りと書き込みを取り消します。

public:
 virtual IAsyncAction ^ CancelIOAsync() = CancelIOAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction CancelIOAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction CancelIOAsync();

function cancelIOAsync()

Public Function CancelIOAsync () As IAsyncAction

戻り値

IAsyncAction

StreamSocket オブジェクトに対する非同期キャンセル操作。

属性

RemoteAsyncAttribute

注釈

CancelIOAsync を呼び出して、アプリが中断されるときに TransferOwnership を呼び出す前に、このソケットで保留中の読み取りまたは書き込みを取り消します。

CancelIOAsync は、完了を通知する前に、すべての読み取り/書き込み完了ハンドラーの実行が完了したことを保証しません。 ただし、完了を通知するまでにすべての I/O 操作が終了状態 (Completed または Error) に達することが保証されます。 保留中のすべての I/O 操作ハンドラーの実行が完了するまでアプリで待機する必要がある場合は、独自のアプリ レベルの sychronization ロジックを実装する必要があります。 Socket Activity Stream Socket サンプルは、これを行う 1 つの方法を示しています。

Note

CancelIOAsync は、Windows ランタイムで保留中の書き込みと読み取りを取り消しますが、ネットワーク ドライバーで保留中の書き込みバッファーがある場合は、書き込みをフラッシュします。