Compartilhar via


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

Confira também

BIND_OPTS

BIND_OPTS2

BIND_OPTS3

Ibindctx