Interface IBindCtx (objidl.h)
Fornece acesso a um contexto de associação, que é um objeto que armazena informações sobre uma operação de associação de moniker específica.
Herança
A interface IBindCtx herda da interface IUnknown . O IBindCtx também tem esses tipos de membros:
Métodos
A interface IBindCtx tem esses métodos.
| IBindCtx::EnumObjectParam Recupera um ponteiro para uma interface que pode ser usada para enumerar as chaves da tabela de ponteiros com chave de cadeia de caracteres do contexto de associação. |
| IBindCtx::GetBindOptions Recupera as opções de associação armazenadas nesse contexto de associação. |
| IBindCtx::GetObjectParam Recupera um ponteiro de interface para o objeto associado à chave especificada na tabela de ponteiros com chave de cadeia de caracteres do contexto de associação. |
| IBindCtx::GetRunningObjectTable Recupera um ponteiro de interface para a ROT (tabela de objetos em execução) para o computador no qual esse contexto de associação está em execução. |
| IBindCtx::RegisterObjectBound Registra um objeto com o contexto de associação para garantir que o objeto permaneça ativo até que o contexto de associação seja liberado. |
| IBindCtx::RegisterObjectParam Associa um objeto a uma chave de cadeia de caracteres na tabela de ponteiros com chave de cadeia de caracteres do contexto de associação. |
| IBindCtx::ReleaseBoundObjects Libera todos os ponteiros para todos os objetos que foram registrados anteriormente por chamadas para RegisterObjectBound. |
| IBindCtx::RevokeObjectBound Remove o objeto do contexto de associação, desfazendo uma chamada anterior para RegisterObjectBound. |
| IBindCtx::RevokeObjectParam Remove a chave especificada e seu ponteiro associado da tabela de objetos com chave de cadeia de caracteres do contexto de associação. A chave deve ter sido inserida anteriormente na tabela com uma chamada para RegisterObjectParam. |
| IBindCtx::SetBindOptions Define novos valores para os parâmetros de associação armazenados no contexto de associação. |
Comentários
Um contexto de associação inclui as seguintes informações:
- Uma estrutura BIND_OPTS que contém um conjunto de parâmetros que não são alterados durante a operação de associação. Quando um moniker composto é associado, cada componente usa o mesmo contexto de associação, portanto, ele atua como um mecanismo para passar os mesmos parâmetros para cada componente de um moniker composto.
- Um conjunto de ponteiros para objetos que a operação de associação ativou. O contexto de associação contém ponteiros para esses objetos associados, mantendo-os carregados e, portanto, eliminando ativações redundantes se os objetos forem necessários novamente durante operações de associação subsequentes.
- Um ponteiro para a ROT (tabela de objetos em execução) no mesmo computador que o processo que iniciou a operação de associação. As implementações do Moniker que precisam acessar o ROT devem usar o método IBindCtx::GetRunningObjectTable em vez de usar a função GetRunningObjectTable . Isso permite aprimoramentos futuros na implementação IBindCtx do sistema para modificar o comportamento de associação.
- Uma tabela de ponteiros de interface, cada um associado a uma chave de cadeia de caracteres. Essa funcionalidade permite que as implementações de moniker armazenem ponteiros de interface em uma cadeia de caracteres conhecida para que possam ser recuperadas posteriormente do contexto de associação. Por exemplo, o OLE define várias chaves de cadeia de caracteres ("ExceededDeadline", "ConnectManually" e assim por diante) que podem ser usadas para armazenar um ponteiro para o objeto que causou um erro durante uma operação de associação.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | objidl.h |