Compartilhar via


Método IUPnPServiceAsync::CancelAsyncOperation (upnp.h)

O método CancelAsyncOperation cancela uma operação assíncrona pendente iniciada pelos métodos BeginInvokeAction, BeginQueryStateVariable, BeginSubscribeToEvents ou BeginSCPDDownload .

Sintaxe

HRESULT CancelAsyncOperation(
  [in] ULONG64 ullRequestID
);

Parâmetros

[in] ullRequestID

Um valor ULONG de 64 bits que corresponde à operação UPnP assíncrona pendente.

Retornar valor

Retornará S_OK se houver êxito. Caso contrário, o método retornará um código de erro COM definido em WinError.h ou um dos seguintes valores:

Código de retorno Descrição
E_FAIL
Falha ao cancelar a operação assíncrona.
E_INVALIDARG
ullRequestID não corresponde à chamada assíncrona pendente.

Comentários

Chamando esse método para uma operação BeginSCPDDownload pendente, o download do SCPD ainda ocorrerá em segundo plano, mas não notificará os retornos de chamada de eventos associados à operação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho upnp.h
DLL Upnp.dll

Confira também

IUPnPServiceAsync

IUPnPServiceAsync::BeginInvokeAction

IUPnPServiceAsync::BeginQueryStateVariable

IUPnPServiceAsync::BeginSCPDDownload

IUPnPServiceAsync::BeginSubscribeToEvents