Enumeração BINDSPEED (oleidl.h)

  • Artigo

Indica aproximadamente quanto tempo o chamador aguardará para associar a um objeto .

Syntax

typedef enum tagBINDSPEED {
  BINDSPEED_INDEFINITE = 1,
  BINDSPEED_MODERATE = 2,
  BINDSPEED_IMMEDIATE = 3
} BINDSPEED;

Constantes

 
BINDSPEED_INDEFINITE
Valor: 1
Não há limite de tempo na operação de associação.
BINDSPEED_MODERATE
Valor: 2
A operação de associação deve ser concluída em um período moderado.

Se esse sinalizador for especificado, a implementação de IOleItemContainer::GetObject deverá retornar MK_E_EXCEEEDEDDEADLINE a menos que o tom do seguinte seja verdadeiro:


  • O objeto já está no estado em execução.

  • O objeto é um pseudo-objeto (um objeto interno para o contêiner de item, como um intervalo de células em uma planilha ou um intervalo de caracteres em um processador de palavras).

  • O objeto tem suporte de um servidor em processo (portanto, ele está sempre no estado em execução quando é carregado). Nesse caso, GetObject deve carregar o objeto designado e, se a função OleIsRunning indicar que o objeto está em execução, retornará com êxito.

BINDSPEED_IMMEDIATE
Valor: 3
O chamador aguardará apenas um pouco. Nesse caso, a operação de associação deve retornar MK_E_EXCEEEDEDDEADLINE a menos que o objeto já esteja no estado em execução ou seja um pseudo-objeto.

Comentários

A implementação do moniker de item fornecido pelo sistema é o principal chamador de IOleItemContainer::GetObject. O valor BINDSPEED especificado depende do prazo especificado pelo chamador da operação moniker.

O prazo é armazenado no campo dwTickCountDeadline da estrutura BIND_OPTS no contexto de associação passado para a operação moniker. Esse valor é baseado no valor retornado da função GetTickCount . Se dwTickCountDeadline for zero, indicando que não há prazo, a implementação do moniker de item especificará BINDSPEED_INDEFINITE. (Esse é o valor padrão dwTickCountDeadline para um contexto de associação retornado pela função CreateBindCtx .) Se a diferença entre dwTickCountDeadline e o valor retornado por GetTickCount for maior que 2500, a implementação do moniker de item especificará BINDSPEED_MODERATE. Se a diferença for menor que 2500, a implementação do moniker de item especificará BINDSPEED_IMMEDIATE.

As implementações de GetObject podem usar o valor BINDSPEED como uma aproximação de atalho do prazo de associação ou podem usar o parâmetro de instância IBindCtx para determinar o prazo exato.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho oleidl.h

Confira também

BIND_OPTS

Ibindctx

IOleItemContainer::GetObject