BIND_OPTS

9/8/2008

Essa estrutura contém parâmetros usados durante uma moniker-operação ligação.

O BIND_OPTS2 estrutura pode ser usada em seu local.

A BIND_OPTS estrutura é armazenada em um contexto BIND. O mesmo contexto BIND é usado por cada componente de uma composição moniker durante ligação, permitindo que os mesmos parâmetros a serem passados para todos os componentes de uma composição moniker. Para obter mais informações sobre contextos BIND, consulte IBindCtx.

Se você tem um cliente moniker (isto é, se você usar um moniker para adquirir um ponteiro interface para um objeto), você faz geralmente não precisará especificar valores para os membros dessa estrutura.

O CreateBindCtx função cria um contexto BIND com as opções BIND definidas para valores usar como padrão que são adequados para maioria das situações. O BindMoniker função faz o mesmo ao criar um contexto BIND para uso na ligação um moniker.

Se você desejar modificar os valores desses BIND opções, você poderá fazê-lo passar um BIND_OPTS estrutura para o IBindCtx::SetBindOptions método.

Moniker implementadores podem transmitir uma BIND_OPTS estrutura para o IBindCtx::GetBindOptions método para recuperar os valores de essas opções BIND.

O BIND_OPTS estrutura é definida em Objidl.h.

Syntax

typedef struct tagBIND_OPTS {
  DWORD cbStruct; 
  DWORD grfFlags; 
  DWORD grfMode; 
  DWORD dwTickCountDeadline; 
} BIND_OPTS, *LPBIND_OPTS; 

Os membros

• cbStruct
  Tamanho dessa estrutura em bytes (that is, o tamanho das BIND_OPTS estrutura).

• grfFlags
  Sinalizadores que aspectos controle de operações ligação moniker.

  Esse valor é uma combinação de sinalizadores bit in a BIND_FLAGS enumeração. Novos valores podem ser definidos no futuro, para implementações moniker devem ignorar bits neste campo eles não entendem.

  O CreateBindCtx função inicializa esse campo para zero.

• grfMode
  Sinalizadores que devem ser usados quando abrir o arquivo que contém o objeto identificado pelo moniker.

  Os valores são tirados a partir de STGM enumeração.

  A operação ligação usa esses sinalizadores na chamar para IPersistFile::Load Ao carregar o arquivo.

  Se o objeto é execução, esses sinalizadores são ignorados por operação de ligação.

  O CreateBindCtx função inicializa esse membro para STGM_READWRITE.

• dwTickCountDeadline
  Relógio tempo (em milissegundos, conforme retornado pelo ObterContagemMarcaEscala função) pelo qual o chamador quer a operação ligação a serem concluídas.

  Este membro permite que o limite chamador tempo de execução de uma operação quando a velocidade é de primário importância.

  Um valor de zero indica que há não prazo.

  Chamadores mais geralmente usam essa funcionalidade quando chamado a IMoniker::GetTimeOfLastChange método, embora ele pode ser útil aplicado a outras operações bem.

  O CreateBindCtx função inicializa esse membro para zero.

  Prazos típicos permitem algumas centenas de milissegundos de execução. Este prazo final é uma recomendação, não um requisito; No entanto, as operações que excedem seu prazo por uma quantidade grande pode causar atrasos para o usuário.

  Cada implementação moniker deve tentar completo sua operação pelo prazo ou falhas com o erro MK_E_EXCEEDEDDEADLINE.

  Se uma operação ligação ultrapassa seu prazo final porque um ou mais objetos que ele precisa não são execução, a implementação moniker deve registrar os Objetos responsáveis no contexto de BIND usando IBindCtx::RegisterObjectParam.

  Os objetos devem ser registrados em nomes de parâmetro "ExceededDeadline " "ExceededDeadline1 " "ExceededDeadline2,, e assim por diante. Se o chamador posteriormente encontrar o objeto na tabela de objetos em execução, o chamador pode repetir a operação ligação.

  O ObterContagemMarcaEscala função indica o número de milissegundos desde inicialização sistema e quebra voltar para zero após 2 ^ 31 milissegundos. Conseqüentemente, os chamadores devem ser cuidadoso não para inadvertidamente transmitir um zero valor, que não indica nenhuma prazo e implementações moniker deve estar ciente dos problemas quebra automática relógio. Para obter mais informações, consulte o ObterContagemMarcaEscala função.

Requirements

Header	objidl.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

BIND_FLAGS
STGM
BindMoniker
CreateBindCtx
IMoniker::GetTimeOfLastChange
IPersistFile::Load
BIND_OPTS2

Other Resources

GetTickCount