Método IBindCtx::SetBindOptions (objidl.h)
Define novos valores para os parâmetros de associação armazenados no contexto de associação.
Sintaxe
HRESULT SetBindOptions(
[in] BIND_OPTS *pbindopts
);
Parâmetros
[in] pbindopts
Um ponteiro para uma estrutura BIND_OPTS3 que contém os parâmetros de associação.
Valor retornado
Esse método pode retornar os valores retornados padrão E_OUTOFMEMORY e S_OK.
Comentários
Um contexto de associação contém um bloco de parâmetros que são comuns à maioria das operações IMoniker . Esses parâmetros não são alterados à medida que a operação passa de parte para parte de um moniker composto.
As operações de associação subsequentes podem chamar IBindCtx::GetBindOptions para recuperar esses parâmetros.
Anotações aos Chamadores
Esse método pode ser chamado por clientes moniker (aqueles que usam monikers para adquirir ponteiros de interface para objetos).Quando você cria um contexto de associação pela primeira vez usando a função CreateBindCtx , os campos da estrutura BIND_OPTS são inicializados com os seguintes valores:
cbStruct = sizeof(BIND_OPTS);
grfFlags = 0;
grfMode = STGM_READWRITE;
dwTickCountDeadline = 0;
Você pode usar o método IBindCtx::SetBindOptions para modificar esses valores antes de usar o contexto de associação, se quiser valores diferentes dos padrões.
SetBindOptions copia os membros da estrutura especificada, mas não a estrutura COSERVERINFO e os ponteiros que ela contém. Os chamadores podem não liberar esses ponteiros até que o contexto de associação seja liberado.
Requisitos
| 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 |