Clase CBindStatusCallback

Artículo
02/19/2013

Esta clase implementa la interfaz IBindStatusCallback.

Importante
Esta clase y sus miembros no se pueden utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.

template <class T, int nBindFlags= BINDF_ASYNCHRONOUS | 
BINDF_ASYNCSTORAGE | BINDF_GETNEWESTVERSION | BINDF_NOWRITECACHE>
class ATL_NO_VTABLE CBindStatusCallback : public CComObjectRootEx
<T::_ThreadModel::ThreadModelNoCS>, public IBindStatusCallbackImpl<T>

Parámetros

T
La clase que contiene la función que se denominaría como datos se reciben.
nBindFlags
Especifica marcadores de enlace devueltos por GetBindInfo.La implementación predeterminada establece el enlace para ser asincrónica, recupera la versión más reciente de datos/objeto, y no almacena datos recuperados en la memoria caché del disco.

Members

Constructores públicos

Name	Descripción
CBindStatusCallback::CBindStatusCallback	el constructor.
CBindStatusCallback::~CBindStatusCallback	El destructor.

Métodos públicos

Name	Descripción
CBindStatusCallback::Download	Método estático que inicia el proceso de descarga, crea un objeto de CBindStatusCallback , y llama a StartAsyncDownload.
CBindStatusCallback::GetBindInfo	Llamado por el moniker asincrónico para solicitar información en el tipo de enlace que se va a crear.
CBindStatusCallback::GetPriority	Llamado por el moniker asincrónico para obtener la prioridad de la operación de enlace.la implementación de ATL devuelve E_NOTIMPL.
CBindStatusCallback::OnDataAvailable	Denominado para proporcionar datos a la aplicación como disponible.Lee los datos, después llama a la función pasada a él para utilizar los datos.
CBindStatusCallback::OnLowResource	Se invoca cuando los recursos son baja.la implementación de ATL devuelve S_OK.
CBindStatusCallback::OnObjectAvailable	Llamado por el moniker asincrónico para pasar un puntero de interfaz del objeto a la aplicación.la implementación de ATL devuelve S_OK.
CBindStatusCallback::OnProgress	Denominado para indicar el progreso de un proceso de transferencia de datos.la implementación de ATL devuelve S_OK.
CBindStatusCallback::OnStartBinding	Al enlazar se inicia.
CBindStatusCallback::OnStopBinding	Llamado cuando se detiene la transferencia de datos asincrónica.
CBindStatusCallback::StartAsyncDownload	Inicializa los bytes disponibles y los bytes leen en cero, crea un objeto de secuencia de inserción- tipo de una dirección URL, y se llama OnDataAvailable cada vez que los datos están disponibles.

Miembros de datos públicos

Name	Descripción
CBindStatusCallback::m_dwAvailableToRead	Número de bytes disponible para leer.
CBindStatusCallback::m_dwTotalRead	Número total de bytes leídos.
CBindStatusCallback::m_pFunc	Puntero a la función llamada cuando los datos están disponibles.
CBindStatusCallback::m_pT	Puntero al objeto que solicita la transferencia de datos asincrónica.
CBindStatusCallback::m_spBindCtx	Puntero a la interfaz de IBindCtx para la operación actual del enlace.
CBindStatusCallback::m_spBinding	Puntero a la interfaz de IBinding para la operación actual del enlace.
CBindStatusCallback::m_spMoniker	Puntero a la interfaz de IMoniker para que la dirección URL utilice.
CBindStatusCallback::m_spStream	Puntero a la interfaz de IStream para la transferencia de datos.

Comentarios

La clase CBindStatusCallback implementa la interfaz IBindStatusCallback.IBindStatusCallback se debe implementar a la aplicación de modo que puede recibir notificaciones de una transferencia de datos asincrónica.El moniker asincrónico proporcionado por el sistema utiliza los métodos de IBindStatusCallback para enviar y recibir información sobre la descarga de datos asincrónica en el objeto.

Normalmente, el objeto de CBindStatusCallback está asociado a una operación específica del enlace.Por ejemplo, en el ejemplo de ASYNC , cuando se establece la propiedad URL, crea un objeto de CBindStatusCallback en la llamada a Download:

STDMETHOD(put_URL)(BSTR newVal)
{
   HRESULT hResult = E_UNEXPECTED;

   ATLTRACE(_T("IATLAsync::put_URL\n"));
   m_bstrURL = newVal;

   if (::IsWindow(m_EditCtrl.m_hWnd))
   {
      ::SendMessage(m_EditCtrl.m_hWnd, WM_SETTEXT, 0,  (LPARAM)_T(""));
      hResult = CBindStatusCallback<CATLAsync>::Download(this, &CATLAsync::OnData, 
         m_bstrURL, m_spClientSite, FALSE);
   }

   return hResult;
}

El moniker asincrónico utiliza la función de devolución de llamada OnData para llamar a su aplicación cuando tiene datos.El moniker asincrónico proporcionado por el sistema.

Jerarquía de herencia

CComObjectRootBase

IBindStatusCallback

CComObjectRootEx

CBindStatusCallback

Requisitos

encabezado: atlctl.h

Vea también

Otros recursos

Información general de la clase ATL