IUPnPServiceAsync::EndInvokeAction-Methode (upnp.h)

Artikel
08/26/2023

Die EndInvokeAction-Methode ruft die Ergebnisse eines vorherigen BeginInvokeAction-Vorgangs und die resultierenden Ausgabeargumente ab.

Syntax

HRESULT EndInvokeAction(
  [in, out] ULONG64 ullRequestID,
  [in, out] VARIANT *pvOutActionArgs,
  [in]      VARIANT *pvRetVal
);

Parameter

[in, out] ullRequestID

Enthält bei der Eingabe einen Verweis auf ein leeres Array. Empfängt bei der Ausgabe einen Verweis auf das Array dienstspezifischer Ausgabeargumente. Falls die Aktion keine Ausgabeargumente enthält, enthält dieser Parameter ein leeres Array.

Hinweis Löschen Sie diesen Parameter mit VariantClear.

[in, out] pvOutActionArgs

Bei eingabe enthält einen Verweis auf ein leeres Array. Empfängt bei der Ausgabe einen Verweis auf einen VARIANT-Wert, der den Rückgabewert der aufgerufenen Aktion enthält.

Hinweis Löschen Sie diesen Parameter mit VariantClear.

[in] pvRetVal

Ein 64-Bit-ULONG-Wert , der dem vor diesem Aufruf initiierten BeginInvokeAction-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
UPNP_E_DEVICE_TIMEOUT	Das Gerät hat innerhalb des Timeoutzeitraums von 30 Sekunden nicht geantwortet.
UPNP_E_DEVICE_ERROR	Ein unbekannter Fehler ist aufgetreten.
UPNP_E_INVALID_ARGUMENTS	Mindestens eines der übergebenen Argumente ist ungültig.
UPNP_E_INVALID_ACTION	Diese Aktion wird vom Gerät nicht unterstützt.
UPNP_E_ERROR_PROCESSING_RESPONSE	Das Gerät hat eine Antwort gesendet, die nicht verarbeitet werden kann. Beispielsweise wurde die Antwort beschädigt.
UPNP_E_PROTOCOL_ERROR	Fehler auf UPnP-Steuerungsprotokollebene.
UPNP_E_TRANSPORT_ERROR	Ein HTTP-Fehler ist aufgetreten. Verwenden Sie die IUPnPService::LastTransportStatus-Eigenschaft, um den tatsächlichen HTTP-status Code abzurufen. Hinweis Dieser Fehlercode wird auch zurückgegeben, wenn die SOAP-Antwort 100 KB überschreitet.

Hinweis Einige Werte können darauf hindeuten, dass ein Fehler von einem UPnP-zertifizierten Gerät empfangen wurde. Weitere Informationen finden Sie unter Gerätefehlercodes.

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

IUPnPService::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync::BeginInvokeAction

Freigeben über