StreamSocket.CancelIOAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取消對 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
傳回
一個對 StreamSocket 物件進行非同步取消操作。
- 屬性
備註
在你的應用程式即將被暫停時,先呼叫 CancelIOAsync 取消這個套接字上所有待處理的讀寫,再呼叫 TransferOwnership 。
CancelIOAsync 並不保證所有讀寫完成處理器在完成前已完成執行。 不過,它保證所有 I/O 操作在表示完成時都已達到終端狀態(完成或錯誤)。 如果你的應用程式需要等待所有待處理的 I/O 操作處理器執行完成,你必須實作自己的應用程式層級同步邏輯。 Socket Activity Stream Socket 範例示範了一種做法。
備註
CancelIOAsync 會在 Windows 執行階段 中取消待處理的寫入與讀取,但如果網路驅動程式中有寫入緩衝區,則會清除寫入。