IUPnPServiceAsync::CancelAsyncOperation-Methode (upnp.h)
Die CancelAsyncOperation-Methode bricht einen ausstehenden asynchronen Vorgang ab, der von den Methoden BeginInvokeAction, BeginQueryStateVariable, BeginSubscribeToEvents oder BeginSCPDDownload initiiert wurde.
Syntax
HRESULT CancelAsyncOperation(
[in] ULONG64 ullRequestID
);
Parameter
[in] ullRequestID
Ein 64-Bit-ULONG-Wert , der dem ausstehenden asynchronen UPnP-Vorgang entspricht.
Rückgabewert
Gibt bei Erfolg S_OK zurück. Andernfalls gibt die Methode einen COM-Fehlercode zurück, der in WinError.h oder einen der folgenden Werte definiert ist:
| Rückgabecode | Beschreibung |
|---|---|
|
Fehler beim Abbrechen des asynchronen Vorgangs. |
|
ullRequestID stimmt nicht mit dem ausstehenden asynchronen Aufruf überein. |
Hinweise
Beim Aufrufen dieser Methode für einen ausstehenden BeginSCPDDownload-Vorgang findet der SCPD-Download weiterhin im Hintergrund statt. Rückrufe werden jedoch nicht über Ereignisse benachrichtigt, die dem Vorgang zugeordnet sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |
Weitere Informationen
IUPnPServiceAsync::BeginInvokeAction
IUPnPServiceAsync::BeginQueryStateVariable