Compartir a través de

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

  • Artículo

El método BeginQueryStateVariable inicia una solicitud asincrónica para el valor de la variable de estado de un servicio específico. Además, si la participación se indica para una suscripción de eventos y descarga diferida del Protocolo de control de servicios (SCPD), y no se ha realizado ya, este método iniciará la descarga y la suscripción de eventos de SCPD.

Sintaxis

HRESULT BeginQueryStateVariable(
  [in]           BSTR             bstrVariableName,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

Parámetros

[in] bstrVariableName

Especifica el valor de variable de estado solicitado.

[in, optional] pAsyncResult

Puntero a un objeto IUPnPAsyncResult . Una vez completada la llamada BeginQueryStateVariable , UPnP usará el método IUPnPAsyncResult::AsyncOperationComplete para notificar al punto de control.

[out] pullRequestID

Puntero a un valor ULONG de 64 bits usado para identificar la operación de E/S asincrónica. El punto de control UPnP debe usar este identificador al finalizar o cancelar esta operación con EndQueryStateVariable.

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
E_FAIL
 No se pudo iniciar la operación asincrónica.
UPNP_E_INVALID_VARIABLE
 La variable de estado solicitada, indicada por bstrVariableName, no existe.
 
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.
 

Comentarios

La suscripción a eventos debe completarse antes de consultar cualquier variable de estado con eventos con este método. Si esto no ocurre, se devuelve UPNP_E_VARIABLE_VALUE_UNKNOWN y la suscripción de eventos se realizará internamente. Como resultado, la siguiente llamada BeginQueryStateVariable se realizará correctamente.

Nota En el caso de los servicios sin variables con eventos, este método siempre se comportará según lo previsto.
 

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

IUPnPServiceAsync

IUPnPServiceAsync::CancelAsyncOperation