Compartir a través de

Función CreateAsyncBindCtx (urlmon.h)

  • Artículo

Crea un contexto de enlace asincrónico para su uso con monikers asincrónicos.

Sintaxis

HRESULT CreateAsyncBindCtx(
  [in]  DWORD               reserved,
  [in]  IBindStatusCallback *pBSCb,
  [in]  IEnumFORMATETC      *pEFetc,
  [out] IBindCtx            **ppBC
);

Parámetros

[in] reserved

Este parámetro está reservado y debe ser 0.

[in] pBSCb

Puntero a la interfaz IBindStatusCallback que se usa para recibir la disponibilidad de datos y la notificación de progreso.

[in] pEFetc

Puntero a la interfaz IEnumFORMATETC que se puede usar para enumerar formatos de negociación de formato durante el enlace. Este parámetro puede ser NULL, en cuyo caso el autor de la llamada no está interesado en la negociación de formato durante el enlace y el formato predeterminado del objeto se enlazará.

[out] ppBC

Dirección de una variable de puntero IBindCtx* que recibe el puntero de interfaz al nuevo contexto de enlace.

Valor devuelto

Esta función puede devolver los valores siguientes.

Código devuelto Descripción
S_OK
 La operación se ha completado correctamente.
E_OUTOFMEMORY
El método se quedó sin memoria y no se completó.
E_INVALIDARG
 Uno o varios parámetros no son válidos.

Comentarios

Esta función registra automáticamente las interfaces IBindStatusCallback e IEnumFORMATETC con el contexto de enlace. El cliente puede especificar marcas de BSCO_OPTION para indicar qué notificaciones de devolución de llamada puede recibir el cliente. Si el cliente no desea recibir una notificación determinada, puede optar por implementar esos métodos de devolución de llamada como códigos auxiliares de función vacíos (devolviendo E_NOTIMPL) y no se debe llamar a ellos.

La función RegisterBindStatusCallback también se puede usar para registrar interfaces de devolución de llamada en el contexto de enlace.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado urlmon.h
Library Urlmon.lib
Archivo DLL Urlmon.dll

Consulte también

IBindStatusCallback

RegisterBindStatusCallback