Compartir a través de

Método IUPnPServiceAsync::EndQueryStateVariable (upnp.h)

  • Artículo

El método EndQueryStateVariable recupera los resultados de una operación BeginQueryStateVariable anterior y recupera el valor de variable de estado específico del servicio resultante.

Sintaxis

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

Parámetros

[in] ullRequestID

Puntero a un valor ULONG de 64 bits que corresponde a la operación BeginQueryStateVariable iniciada antes de esta llamada.

[out, retval] pValue

En la entrada, contiene una matriz vacía. En la salida, recibe una referencia al valor de la variable especificada en BeginQueryStateVariable por bstrVariableName. El tipo de los datos devueltos depende de la variable de estado para la que se invocó la consulta.

Nota Borre este parámetro con VariantClear.
 

Valor devuelto

Devuelve S_OK si se realiza correctamente. De lo contrario, el método devuelve un código de error COM definido en WinError.h o uno de los valores siguientes:

Código devuelto Descripción
UPNP_E_DEVICE_ERROR
 La variable de estado no tiene eventos y la consulta remota devolvió un código de error. Esto no es un error de transporte; el dispositivo recibió la solicitud, pero devolvió un error.
UPNP_E_INVALID_VARIABLE
 La variable de estado solicitada no existe.
UPNP_E_DEVICE_TIMEOUT
 El dispositivo no ha respondido dentro del período de tiempo de espera de 30 segundos.
UPNP_E_INVALID_ARGUMENTS
 Uno o varios de los argumentos pasados con vInActionArgs no son válidos.
UPNP_E_PROTOCOL_ERROR
 La consulta no se completó debido a problemas en el nivel de protocolo UPnP.
UPNP_E_TRANSPORT_ERROR
 No se ha producido un evento en la variable de estado y se produjo un error en la consulta remota para el valor debido a un problema HTTP. Para recuperar el código de error HTTP, use IUPnPService::LastTransportStatus.
UPNP_E_VARIABLE_VALUE_UNKNOWN
 Se produce un evento en la variable de estado, pero el software UPnP no puede devolver un valor porque sigue esperando una notificación de eventos.
 
Nota Algunos valores pueden indicar que se recibió un error de un dispositivo certificado por UPnP. Para obtener más información, consulte Códigos de error del dispositivo.
 

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado upnp.h
Archivo DLL Upnp.dll

Consulte también

IUPnPService::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync::EndQueryStateVariable