共用方式為


IUPnPServiceAsync::CancelAsyncOperation 方法 (upnp.h)

CancelAsyncOperation 方法會取消 BeginInvokeActionBeginQueryStateVariableBeginSubscribeToEventsBeginSCPDDownload 方法所起始的暫止異步操作。

語法

HRESULT CancelAsyncOperation(
  [in] ULONG64 ullRequestID
);

參數

[in] ullRequestID

對應至暫止異步 UPnP 作業的 64 位 ULONG 值。

傳回值

傳回成功時的 S_OK 。 否則,方法會傳回 WinError.h 或下列其中一個值中定義的 COM 錯誤碼:

傳回碼 Description
E_FAIL
無法取消異步操作。
E_INVALIDARG
ullRequestID 不符合暫止的異步呼叫。

備註

針對擱 置的 BeginSCPDDownload 作業呼叫這個方法,SCPD 下載仍會在背景進行,但不會通知與作業相關聯的事件回呼。

規格需求

需求
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 upnp.h
Dll Upnp.dll

另請參閱

IUPnPServiceAsync

IUPnPServiceAsync::BeginInvokeAction

IUPnPServiceAsync::BeginQueryStateVariable

IUPnPServiceAsync::BeginSCPDDownload

IUPnPServiceAsync::BeginSubscribeToEvents