PeerNameResolver.ResolveAsyncCancel(Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取消指定的非同步對等名稱解析要求。
public:
void ResolveAsyncCancel(System::Object ^ userState);
[System.Security.SecurityCritical]
public void ResolveAsyncCancel (object userState);
[<System.Security.SecurityCritical>]
member this.ResolveAsyncCancel : obj -> unit
Public Sub ResolveAsyncCancel (userState As Object)
參數
- userState
- Object
提供給啟動解析作業的 ResolveAsync 方法執行個體的物件。
- 屬性
例外狀況
userState
參數不可以是 null
。
備註
呼叫這個方法可確保系統不會嘗試取得指定 PeerName之的其他記錄。 如果異步對等名稱解析作業未完成時呼叫這個方法,它會作為「無作業」 (NO OP) 。
userState
必須提供 對象,因為它用來追蹤進行多個呼叫時的特定異步呼叫。 這個呼叫端提供的對象對於每個對等名稱解析要求而言都是唯一的。
此方法會立即傳回,但作業可能或可能不會立即取消。 事件傳 ResolveCompleted 回的事件自變數包含一個字段,用戶端可以輪詢以判斷是否發生取消。
呼叫此方法可確保 ResolveCompleted 事件會儘快發出訊號,並將事件自變數 Cancelled 設定為 true
。