IUPnPServiceAsync::EndQueryStateVariable-Methode (upnp.h)

Artikel
08/26/2023

Die EndQueryStateVariable-Methode ruft die Ergebnisse eines vorherigen BeginQueryStateVariable-Vorgangs und den resultierenden dienstspezifischen Zustandsvariablenwert ab.

Syntax

HRESULT EndQueryStateVariable(
  [in]          ULONG64 ullRequestID,
  [out, retval] VARIANT *pValue
);

Parameter

[in] ullRequestID

Zeiger auf einen 64-Bit-ULONG-Wert , der dem vor diesem Aufruf initiierten BeginQueryStateVariable-Vorgang entspricht.

[out, retval] pValue

Enthält bei der Eingabe ein leeres Array. Empfängt bei der Ausgabe einen Verweis auf den Wert der Variablen, die in BeginQueryStateVariable by bstrVariableName angegeben ist. Der Typ der zurückgegebenen Daten hängt von der Zustandsvariablen ab, für die die Abfrage aufgerufen wurde.

Hinweis Löschen Sie diesen Parameter mit VariantClear.

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_ERROR	Die Zustandsvariable wird nicht ausgelöst, und die Remoteabfrage hat einen Fehlercode zurückgegeben. Dies ist kein Transportfehler; Das Gerät hat die Anforderung empfangen, aber es hat einen Fehler zurückgegeben.
UPNP_E_INVALID_VARIABLE	Die angeforderte Zustandsvariable ist nicht vorhanden.
UPNP_E_DEVICE_TIMEOUT	Das Gerät hat innerhalb des Timeoutzeitraums von 30 Sekunden nicht geantwortet.
UPNP_E_INVALID_ARGUMENTS	Mindestens eines der Argumente, die mit vInActionArgs übergeben werden, ist ungültig.
UPNP_E_PROTOCOL_ERROR	Die Abfrage wurde aufgrund von Problemen auf UPnP-Protokollebene nicht abgeschlossen.
UPNP_E_TRANSPORT_ERROR	Die Zustandsvariable wird nicht ausgelöst, und die Remoteabfrage für den Wert ist aufgrund eines HTTP-Problems fehlgeschlagen. Verwenden Sie zum Abrufen des HTTP-Fehlercodes IUPnPService::LastTransportStatus.
UPNP_E_VARIABLE_VALUE_UNKNOWN	Die Zustandsvariable ist ereignisbehaftet, aber die UPnP-Software kann keinen Wert zurückgeben, da sie immer noch auf eine Ereignisbenachrichtigung wartet.

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


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::EndQueryStateVariable

Freigeben über