IUPnPServiceAsync ::CancelAsyncOperation, méthode (upnp.h)

Article
03/06/2024

La méthode CancelAsyncOperation annule une opération asynchrone en attente lancée par les méthodes BeginInvokeAction, BeginQueryStateVariable, BeginSubscribeToEvents ou BeginSCPDDownload .

Syntaxe

HRESULT CancelAsyncOperation(
  [in] ULONG64 ullRequestID
);

Paramètres

[in] ullRequestID

Valeur ULONG 64 bits qui correspond à l’opération UPnP asynchrone en attente.

Valeur retournée

Renvoie S_OK en cas de réussite. Sinon, la méthode retourne un code d’erreur COM défini dans WinError.h ou l’une des valeurs suivantes :

Code de retour	Description
E_FAIL	Échec de l’annulation de l’opération asynchrone.
E_INVALIDARG	ullRequestID ne correspond pas à l’appel asynchrone en attente.

Remarques

L’appel de cette méthode pour une opération BeginSCPDDownload en attente dont le téléchargement SCPD a toujours lieu en arrière-plan, mais ne notifie pas les rappels des événements associés à l’opération.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	upnp.h
DLL	Upnp.dll