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

Artigo
03/13/2024

O método EndInvokeAction recupera os resultados de uma operação BeginInvokeAction anterior e recupera os argumentos de saída resultantes.

Sintaxe

HRESULT EndInvokeAction(
  [in, out] ULONG64 ullRequestID,
  [in, out] VARIANT *pvOutActionArgs,
  [in]      VARIANT *pvRetVal
);

Parâmetros

[in, out] ullRequestID

Na entrada, contém uma referência a uma matriz vazia. Na saída, recebe uma referência à matriz de argumentos de saída específicos do serviço. Caso a ação não tenha argumentos de saída, esse parâmetro conterá uma matriz vazia.

Nota Limpe esse parâmetro com VariantClear.

[in, out] pvOutActionArgs

Na entrada contém uma referência a uma matriz vazia. Na saída, recebe uma referência a uma VARIANT que contém o valor retornado da ação invocada.

Nota Limpe esse parâmetro com VariantClear.

[in] pvRetVal

Um valor ULONG de 64 bits que corresponde à operação BeginInvokeAction iniciada antes dessa chamada.

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_TIMEOUT	O dispositivo não respondeu dentro do período de tempo limite de 30 segundos.
UPNP_E_DEVICE_ERROR	Ocorreu um erro desconhecido.
UPNP_E_INVALID_ARGUMENTS	Um ou mais dos argumentos passados são inválidos.
UPNP_E_INVALID_ACTION	Não há suporte para essa ação no dispositivo.
UPNP_E_ERROR_PROCESSING_RESPONSE	O dispositivo enviou uma resposta que não pode ser processada; por exemplo, a resposta foi corrompida.
UPNP_E_PROTOCOL_ERROR	Ocorreu um erro no nível do protocolo de controle UPnP.
UPNP_E_TRANSPORT_ERROR	Ocorreu um erro HTTP. Use a propriedade IUPnPService::LastTransportStatus para obter o código http status real. Nota Esse código de erro também é retornado quando a resposta SOAP excede 100 quilobytes.

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

Requisito	Valor
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::BeginInvokeAction

Compartilhar via