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

Artigo
08/26/2023

O método EndQueryStateVariable recupera os resultados de uma operação BeginQueryStateVariable anterior e recupera o valor da variável de estado específica do serviço resultante.

Sintaxe

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

Parâmetros

[in] ullRequestID

Ponteiro para um valor ULONG de 64 bits que corresponde à operação BeginQueryStateVariable iniciada antes dessa chamada.

[out, retval] pValue

Na entrada, contém uma matriz vazia. Na saída, recebe uma referência ao valor da variável especificada em BeginQueryStateVariable por bstrVariableName. O tipo dos dados retornados depende da variável de estado para a qual a consulta foi invocada.

Nota Limpe esse parâmetro com VariantClear.

Retornar valor

Retornará S_OK se houver êxito. Caso contrário, o método retorna um código de erro COM definido em WinError.h ou um dos seguintes valores:

Código de retorno	Descrição
UPNP_E_DEVICE_ERROR	A variável de estado não é evented e a consulta remota retornou um código de erro. Isso não é um erro de transporte; o dispositivo recebeu a solicitação, mas retornou um erro.
UPNP_E_INVALID_VARIABLE	A variável de estado solicitada não existe.
UPNP_E_DEVICE_TIMEOUT	O dispositivo não respondeu dentro do período de tempo limite de 30 segundos.
UPNP_E_INVALID_ARGUMENTS	Um ou mais dos argumentos passados com vInActionArgs são inválidos.
UPNP_E_PROTOCOL_ERROR	A consulta não foi concluída devido a problemas no nível do protocolo UPnP.
UPNP_E_TRANSPORT_ERROR	A variável de estado não é evented e a consulta remota para o valor falhou devido a um problema HTTP. Para recuperar o código de erro HTTP, use IUPnPService::LastTransportStatus.
UPNP_E_VARIABLE_VALUE_UNKNOWN	A variável de estado é evented, mas o software UPnP não pode retornar um valor porque ainda está aguardando uma notificação de evento.

Nota Alguns valores podem indicar que um erro foi recebido de um dispositivo certificado por UPnP. Para obter mais informações, consulte Códigos de erro do dispositivo.

Requisitos


Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	upnp.h
DLL	Upnp.dll

Confira também

IUPnPService::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync::EndQueryStateVariable

Compartilhar via