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

Artigo
03/13/2024

O método BeginInvokeAction invoca uma ação em um dispositivo no modo assíncrono. Além disso, se uma assinatura de evento e download de SCPD atrasada for aceita e ainda não tiver ocorrido, esse método iniciará o download do SCPD.

Sintaxe

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

Parâmetros

[in] bstrActionName

Especifica o método a ser invocado.

[in] vInActionArgs

Especifica uma matriz de argumentos de entrada para o método . Se a ação não tiver argumentos de entrada, esse parâmetro deverá conter uma matriz vazia. O conteúdo dessa matriz é específico do serviço.

[in, optional] pAsyncResult

Ponteiro para um objeto IUPnPAsyncResult . Quando a chamada BeginInvokeAction for concluída, o UPnP usará o método IUPnPAsyncResult::AsyncOperationComplete para notificar o ponto de controle.

[out] pullRequestID

Ponteiro para um valor ULONG de 64 bits usado para identificar a operação de E/S assíncrona. O ponto de controle deve usar esse identificador como um cookie ao encerrar ou cancelar essa operação com EndInvokeAction.

Retornar valor

Retornará S_OK se houver êxito. Caso contrário, o método retorna um código de erro COM definido em WinError.h ou um dos seguintes valores:

Código de retorno	Descrição
E_PENDING	Outra operação assíncrona está sendo feita neste objeto IUPnPServiceAsync . Crie outra instância IUPnPServiceAsync ou cancele a operação em execução usando IUPnPServiceAsync::CancelAsyncOperation.
E_FAIL	Falha ao iniciar a operação.
UPNP_E_INVALID_ACTION	Não há suporte para essa ação no dispositivo.

Nota Alguns valores podem indicar que um erro foi recebido de um dispositivo certificado por UPnP. Para obter mais informações, consulte Códigos de erro do dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	upnp.h
DLL	Upnp.dll

Confira também

IUPnPServiceAsync

IUPnPServiceAsync::EndInvokeAction

Compartilhar via