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 ，以在應用程式即將暫停時呼叫 TransferOwnership。

CancelIOAsync 不保證所有讀取/寫入完成處理常式在發出完成訊號之前都已完成執行。 不過，它確實保證所有 I/O 作業在發出完成訊號時， (已完成或錯誤) 達到終端狀態。 如果您的應用程式必須等候所有擱置的 I/O 工作處理程式完成執行，您必須實作自己的應用層級 Sychronization 邏輯。 通訊端活動串流通訊端範例會示範執行此動作的其中一種方式。

注意

CancelIOAsync 會取消Windows 執行階段中的擱置寫入和讀取，但如果網路驅動程式中有擱置中的寫入緩衝區，它會排清寫入。