Função CreateAsyncBindCtx (urlmon.h)

Cria um contexto de associação assíncrona para uso com monikers assíncronos.

Sintaxe

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

Parâmetros

[in] reserved

Esse parâmetro é reservado e deve ser 0.

[in] pBSCb

Um ponteiro para a interface IBindStatusCallback usada para receber a notificação de progresso e disponibilidade de dados.

[in] pEFetc

Um ponteiro para a interface IEnumFORMATETC que pode ser usada para enumerar formatos para negociação de formato durante a associação. Esse parâmetro pode ser NULL, caso em que o chamador não está interessado na negociação de formato durante a associação e o formato padrão do objeto será associado.

[out] ppBC

Endereço de uma variável de ponteiro IBindCtx* que recebe o ponteiro de interface para o novo contexto de associação.

Valor retornado

Essa função pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
A operação foi concluída com sucesso.
E_OUTOFMEMORY
O método ficou sem memória e não foi concluído.
E_INVALIDARG
Um ou mais parâmetros são inválidos.

Comentários

Essa função registra automaticamente as interfaces IBindStatusCallback e IEnumFORMATETC com o contexto de associação. O cliente pode especificar sinalizadores de BSCO_OPTION para indicar quais notificações de retorno de chamada o cliente é capaz de receber. Se o cliente não quiser receber determinada notificação, ele poderá optar por implementar esses métodos de retorno de chamada como stubs de função vazios (retornando E_NOTIMPL) e eles não devem ser chamados.

A função RegisterBindStatusCallback também pode ser usada para registrar interfaces de retorno de chamada no contexto de associação.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho urlmon.h
Biblioteca Urlmon.lib
DLL Urlmon.dll

Confira também

Ibindstatuscallback

RegisterBindStatusCallback