Поделиться через


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

Метод BeginInvokeAction вызывает действие на устройстве в асинхронном режиме. Кроме того, если согласие на отложенное скачивание SCPD и подписка на события еще не выполнены, этот метод инициирует загрузку SCPD.

Синтаксис

HRESULT BeginInvokeAction(
  [in]           BSTR             bstrActionName,
  [in]           VARIANT          vInActionArgs,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

Параметры

[in] bstrActionName

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

[in] vInActionArgs

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

[in, optional] pAsyncResult

Указатель на объект IUPnPAsyncResult . После завершения вызова BeginInvokeAction UPnP будет использовать метод IUPnPAsyncResult::AsyncOperationComplete для уведомления контрольной точки.

[out] pullRequestID

Указатель на 64-разрядное значение ULONG , используемое для идентификации асинхронной операции ввода-вывода. Контрольная точка должна использовать этот дескриптор в качестве файла cookie при завершении или отмене этой операции с помощью EndInvokeAction.

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

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

Код возврата Описание
E_PENDING
Для этого объекта IUPnPServiceAsync выполняется другая асинхронная операция. Создайте другой экземпляр IUPnPServiceAsync или отмените выполняющуюся операцию с помощью IUPnPServiceAsync::CancelAsyncOperation.
E_FAIL
Не удалось запустить операцию.
UPNP_E_INVALID_ACTION
Это действие не поддерживается устройством.
 
Примечание Некоторые значения могут указывать на то, что от устройства, сертифицированного UPnP, была получена ошибка. Дополнительные сведения см. в разделе Коды ошибок устройства.
 

Требования

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

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

IUPnPServiceAsync

IUPnPServiceAsync::EndInvokeAction