Compartilhar via

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

  • Artigo

O BeginSubscribeToEvents inicia a assinatura de evento no modo assíncrono e registra o retorno de chamada do aplicativo com a estrutura UPnP.

Sintaxe

HRESULT BeginSubscribeToEvents(
  [in]           IUnknown         *pUnkCallback,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

Parâmetros

[in] pUnkCallback

Especifica a referência ao objeto de interface que contém o retorno de chamada a ser registrado. Esse objeto deve dar suporte à interface IUPnPServiceCallback ou à interface IDispatch .

[in, optional] pAsyncResult

Especifica uma referência ao objeto IUPnPAsyncResult . Quando a chamada BeginSubscribeToEvents 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 ao encerrar ou cancelar a operação por meio de EndSubscribeToEvents ou CancelAsyncOperation.

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_FAIL
 Falha ao iniciar a operação assíncrona.
 
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.
 

Comentários

A assinatura do evento deve ser concluída antes de consultar quaisquer variáveis de estado evented com BeginQueryStateVariable. Se isso não ocorrer, UPNP_E_VARIABLE_VALUE_UNKNOWN será retornado e a assinatura do evento ocorrerá internamente. Como resultado, a próxima chamada BeginQueryStateVariable terá êxito.

Nota Para serviços sem variáveis evented, BeginQueryStateVariable sempre se comportará conforme o esperado.
 
Chamar esse método várias vezes resultará na adição de vários retornos de chamada.

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::CancelAsyncOperation

IUPnPServiceAsync::EndSubscribeToEvents