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

Article
08/26/2023

La méthode EndQueryStateVariable récupère les résultats d’une opération BeginQueryStateVariable précédente et récupère la valeur de variable d’état spécifique au service résultante.

Syntaxe

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

Paramètres

[in] ullRequestID

Pointeur vers une valeur ULONG 64 bits qui correspond à l’opération BeginQueryStateVariable lancée avant cet appel.

[out, retval] pValue

En entrée, contient un tableau vide. À la sortie, reçoit une référence à la valeur de la variable spécifiée dans BeginQueryStateVariable par bstrVariableName. Le type des données retournées dépend de la variable d’état pour laquelle la requête a été appelée.

Note Effacez ce paramètre avec VariantClear.

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
UPNP_E_DEVICE_ERROR	La variable d’état n’est pas événementielle et la requête distante a retourné un code d’erreur. Il ne s’agit pas d’une erreur de transport ; l’appareil a reçu la demande, mais il a renvoyé une erreur.
UPNP_E_INVALID_VARIABLE	La variable d’état demandée n’existe pas.
UPNP_E_DEVICE_TIMEOUT	L’appareil n’a pas répondu dans le délai d’attente de 30 secondes.
UPNP_E_INVALID_ARGUMENTS	Un ou plusieurs des arguments passés avec vInActionArgs ne sont pas valides.
UPNP_E_PROTOCOL_ERROR	La requête ne s’est pas terminée en raison de problèmes au niveau du protocole UPnP.
UPNP_E_TRANSPORT_ERROR	La variable d’état n’est pas événementielle et la requête distante pour la valeur a échoué en raison d’un problème HTTP. Pour récupérer le code d’erreur HTTP, utilisez IUPnPService::LastTransportStatus.
UPNP_E_VARIABLE_VALUE_UNKNOWN	La variable d’état est événementielle, mais le logiciel UPnP ne peut pas retourner une valeur, car il attend toujours une notification d’événement.

Note Certaines valeurs peuvent indiquer qu’une erreur a été reçue d’un appareil certifié UPnP. Pour plus d’informations, consultez Codes d’erreur d’appareil.

Configuration requise


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

Voir aussi

IUPnPService::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync::EndQueryStateVariable

Partager via