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 |
|---|---|
|
A operação foi concluída com sucesso. |
|
O método ficou sem memória e não foi concluído. |
|
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 |