Метод IUPnPService::InvokeAction (upnp.h)

Метод InvokeAction вызывает метод на устройстве.

Синтаксис

HRESULT InvokeAction(
  [in]      BSTR    bstrActionName,
  [in]      VARIANT vInActionArgs,
  [in, out] VARIANT *pvOutActionArgs,
  [in, out] VARIANT *pvRetVal
);

Параметры

[in] bstrActionName

Указывает вызываемый метод.

[in] vInActionArgs

Задает массив входных аргументов для метода . Если у действия нет входных аргументов, этот параметр должен содержать пустой массив.

Содержимое этого массива зависит от службы.

[in, out] pvOutActionArgs

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

Содержимое этого параметра зависит от службы.

Освободите этот параметр с помощью VariantClear.

[in, out] pvRetVal

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

Если устройство возвращает ошибку после вызова с ним действия и для этого параметра не задано значение NULL, этот параметр будет содержать конкретный текст, описывающий ошибку после возврата. Дополнительные сведения об ошибках, возвращаемых устройствами, см. в документации по кодам ошибок устройств .

Освободите этот параметр с помощью VariantClear.

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

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h, или одно из возвращаемых значений UPnP, показанных в следующей таблице. Некоторые из этих значений указывают на то, что с устройства, сертифицированного UPnP, была получена ошибка. Дополнительные сведения см. в разделе Коды ошибок устройства.

Комментарии

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

Требования

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

IUPnPService