Поделиться через


Функция CreateAsyncBindCtx (urlmon.h)

Создает контекст асинхронной привязки для использования с асинхронными моникерами.

Синтаксис

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

Параметры

[in] reserved

Этот параметр зарезервирован и должен иметь значение 0.

[in] pBSCb

Указатель на интерфейс IBindStatusCallback , используемый для получения уведомлений о доступности данных и ходе выполнения.

[in] pEFetc

Указатель на интерфейс IEnumFORMATETC , который можно использовать для перечисления форматов для согласования формата во время привязки. Этот параметр может иметь значение NULL. В этом случае вызывающий объект не заинтересован в согласовании формата во время привязки, и к объекту будет привязан формат по умолчанию.

[out] ppBC

Адрес переменной указателя IBindCtx*, которая получает указатель интерфейса на новый контекст привязки.

Возвращаемое значение

Эта функция может возвращать следующие значения.

Код возврата Описание
S_OK
Операция выполнена успешно.
E_OUTOFMEMORY
В методе закончилась память и он не был завершен.
E_INVALIDARG
Один или несколько параметров недопустимы.

Комментарии

Эта функция автоматически регистрирует интерфейсы IBindStatusCallback и IEnumFORMATETC в контексте привязки. Клиент может указать флаги из BSCO_OPTION, чтобы указать, какие уведомления обратного вызова может получать клиент. Если клиент не хочет получать определенные уведомления, он может реализовать эти методы обратного вызова как пустые заглушки функций (возвращая E_NOTIMPL), и их не следует вызывать.

Функцию RegisterBindStatusCallback также можно использовать для регистрации интерфейсов обратного вызова в контексте привязки.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header urlmon.h
Библиотека Urlmon.lib
DLL Urlmon.dll

См. также раздел

IBindStatusCallback

RegisterBindStatusCallback