IBindCtx::SetBindOptions

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Este método Especifica novos valores para os parâmetros ligação armazenados no contexto de BIND. Operações subseqüentes ligação podem chamar o IBindCtx::GetBindOptions método para recuperar os parâmetros.

Syntax

HRESULT SetBindOptions(
  BIND_OPTS* pbindopts
);

Parameters

pbindopts
[no] Ponteiro para um BIND_OPTS2 ou um BIND_OPTS estrutura contendo os parâmetros ligação.

Return Value

A seguinte tabela mostra os valores de retorno para este método.

Valor	Descrição
E_OUTOFMEMORY	Um padrão valor de retorno.
S_OK	Os parâmetros foram armazenados com êxito.

Remarks

Um contexto BIND contém um bloco de parâmetros, armazenados em um BIND_OPTS2 Ou BIND_OPTS estrutura, que são comum para a maioria IMoniker Operações. Faça esses parâmetros não alteração como a operação se move de informação para parte de uma composição moniker.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Esse método pode ser chamado por clientes moniker (aqueles que usam identificadores de origem para adquirir interface ponteiros para os objetos).

Quando você criar primeiro um contexto BIND usando o CreateBindCtx função, os campos da BIND_OPTS estrutura são inicializados para o seguinte valores.

    cbStruct = sizeof(BIND_OPTS); 
    grfFlags = 0; 
    grfMode = STGM_READWRITE; 
    dwTickCountDeadline = 0;

Se você desejar valores que não seja o padrão, você pode usar o IBindCtx::SetBindOptions método para modificar esses valores antes de usar o contexto BIND. Consulte BIND_OPTS Para obter mais informações.

SetBindOptions Copia somente os membros do BIND_OPTS2, mas não o COSERVERINFO estrutura e os ponteiros que ele contém. Os chamadores podem não livre qualquer um desses ponteiros até que o contexto BIND é lançado.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via