Compartir a través de

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

  • Artículo

El método BeginInvokeAction invoca una acción en un dispositivo en modo asincrónico. Además, si se ha optado por participar en una descarga diferida de SCPD y una suscripción de eventos, y aún no se ha realizado, este método iniciará la descarga de SCPD.

Sintaxis

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

Parámetros

[in] bstrActionName

Especifica el método que se va a invocar.

[in] vInActionArgs

Especifica una matriz de argumentos de entrada para el método . Si la acción no tiene argumentos de entrada, este parámetro debe contener una matriz vacía. El contenido de esta matriz es específico del servicio.

[in, optional] pAsyncResult

Puntero a un objeto IUPnPAsyncResult . Una vez completada la llamada BeginInvokeAction , UPnP usará el método IUPnPAsyncResult::AsyncOperationComplete para notificar al punto de control.

[out] pullRequestID

Puntero a un valor ULONG de 64 bits usado para identificar la operación asincrónica de E/S. El punto de control debe usar este identificador como una cookie al finalizar o cancelar esta operación con EndInvokeAction.

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
E_PENDING
 Se está realizando otra operación asincrónica en este objeto IUPnPServiceAsync . Cree otra instancia IUPnPServiceAsync o cancele la operación en ejecución mediante IUPnPServiceAsync::CancelAsyncOperation.
E_FAIL
 No se pudo iniciar la operación.
UPNP_E_INVALID_ACTION
 El dispositivo no admite esta acción.
 
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

IUPnPServiceAsync

IUPnPServiceAsync::EndInvokeAction