Метод IUPnPServiceAsync::EndInvokeAction (upnp.h)

Метод EndInvokeAction извлекает результаты предыдущей операции BeginInvokeAction и извлекает результирующий выходной аргумент.

Синтаксис

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

Параметры

[in, out] ullRequestID

Во входных данных содержит ссылку на пустой массив. В выходных данных получает ссылку на массив выходных аргументов, относящихся к службе. В случае, если действие не имеет выходных аргументов, этот параметр содержит пустой массив.

Примечание Очистите этот параметр с помощью VariantClear.

 

[in, out] pvOutActionArgs

Во входных данных содержит ссылку на пустой массив. В выходных данных получает ссылку на VARIANT, содержащую возвращаемое значение вызываемого действия.

Примечание Очистите этот параметр с помощью VariantClear.

 

[in] pvRetVal

64-разрядное значение ULONG , соответствующее операции BeginInvokeAction , инициированной до этого вызова.

Возвращаемое значение

Возвращает S_OK при успешном выполнении. В противном случае метод возвращает код ошибки COM, определенный в WinError.h , или одно из следующих значений:

Код возврата	Описание
UPNP_E_DEVICE_TIMEOUT	Устройство не ответило в течение 30-секундного периода ожидания.
UPNP_E_DEVICE_ERROR	Произошла неизвестная ошибка.
UPNP_E_INVALID_ARGUMENTS	Один или несколько переданных аргументов недопустимы.
UPNP_E_INVALID_ACTION	Это действие не поддерживается устройством.
UPNP_E_ERROR_PROCESSING_RESPONSE	Устройство отправило ответ, который не может быть обработан; Например, ответ поврежден.
UPNP_E_PROTOCOL_ERROR	Произошла ошибка на уровне протокола управления UPnP.
UPNP_E_TRANSPORT_ERROR	Произошла ошибка HTTP. Используйте свойство IUPnPService::LastTransportStatus , чтобы получить фактический код состояния HTTP. Примечание Этот код ошибки также возвращается, если ответ SOAP превышает 100 килобайт.

 

Примечание Некоторые значения могут указывать на то, что от устройства, сертифицированного UPnP, была получена ошибка. Дополнительные сведения см. в разделе Коды ошибок устройства.

 

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	upnp.h
DLL	Upnp.dll

См. также раздел

IUPnPService::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync::BeginInvokeAction