Compartir a través de

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

  • Artículo

El método EndInvokeAction recupera los resultados de una operación BeginInvokeAction anterior y recupera los argumentos de salida resultantes.

Sintaxis

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

Parámetros

[in, out] ullRequestID

En la entrada, contiene una referencia a una matriz vacía. En la salida, recibe una referencia a la matriz de argumentos de salida específicos del servicio. En caso de que la acción no tenga argumentos de salida, este parámetro contiene una matriz vacía.

Nota Borre este parámetro con VariantClear.
 

[in, out] pvOutActionArgs

La entrada contiene una referencia a una matriz vacía. En la salida, recibe una referencia a un variant que contiene el valor devuelto de la acción invocada.

Nota Borre este parámetro con VariantClear.
 

[in] pvRetVal

Valor de ULONG de 64 bits que corresponde a la operación BeginInvokeAction iniciada antes de esta llamada.

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_TIMEOUT
 El dispositivo no ha respondido dentro del período de tiempo de espera de 30 segundos.
UPNP_E_DEVICE_ERROR
 Se ha producido un error desconocido.
UPNP_E_INVALID_ARGUMENTS
 Uno o varios de los argumentos pasados no son válidos.
UPNP_E_INVALID_ACTION
 El dispositivo no admite esta acción.
UPNP_E_ERROR_PROCESSING_RESPONSE
 El dispositivo ha enviado una respuesta que no se puede procesar; por ejemplo, la respuesta estaba dañada.
UPNP_E_PROTOCOL_ERROR
 Error en el nivel de protocolo de control UPnP.
UPNP_E_TRANSPORT_ERROR
 Error HTTP. Use la propiedad IUPnPService::LastTransportStatus para obtener el código de estado HTTP real.
Nota Este código de error también se devuelve cuando la respuesta SOAP supera los 100 kilobytes.
 
 
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

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