Compartir a través de

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

  • Artículo

BeginSubscribeToEvents inicia la suscripción de eventos en modo asincrónico y registra la devolución de llamada de la aplicación con el marco UPnP.

Sintaxis

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

Parámetros

[in] pUnkCallback

Especifica la referencia al objeto de interfaz que contiene la devolución de llamada que se va a registrar. Este objeto debe admitir la interfaz IUPnPServiceCallback o la interfaz IDispatch .

[in, optional] pAsyncResult

Especifica una referencia al objeto IUPnPAsyncResult . Cuando se complete la llamada BeginSubscribeToEvents , 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 al finalizar o cancelar la operación a través de EndSubscribeToEvents o CancelAsyncOperation.

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_FAIL
 No se pudo iniciar la operación asincrónica.
 
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.
 

Comentarios

La suscripción de eventos debe completarse antes de consultar las variables de estado con EventQueryStateVariable. Si esto no ocurre, se devuelve UPNP_E_VARIABLE_VALUE_UNKNOWN y la suscripción de eventos tendrá lugar internamente. Como resultado, la siguiente llamada BeginQueryStateVariable se realizará correctamente.

Nota En el caso de los servicios sin variables evented, BeginQueryStateVariable siempre se comportará según lo previsto.
 
Llamar a este método varias veces dará lugar a la adición de varias devoluciones de llamada.

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

IUPnPServiceAsync::EndSubscribeToEvents