Método IGetAppTrackerData::GetSuggestedPollingInterval (comsvcs.h)

Recupera o intervalo mínimo para sondagem sugerido pelo Servidor Rastreador.

Sintaxe

HRESULT GetSuggestedPollingInterval(
  [out] DWORD *PollingIntervalInSeconds
);

Parâmetros

[out] PollingIntervalInSeconds

O intervalo de sondagem sugerido do Servidor Rastreador, em segundos.

Valor retornado

Esse método pode retornar os valores de retorno padrão E_INVALIDARG e S_OK.

Comentários

Os aplicativos que usam dados de rastreador geralmente precisarão sondar o Servidor Rastreador periodicamente para garantir que esses dados sejam atualizados. Por exemplo, um aplicativo administrativo que exibe dados de rastreamento para o usuário normalmente deseja que esses dados estejam próximos do possível em tempo real. No entanto, a sondagem com muita frequência pode prejudicar o desempenho geral do sistema. Lembre-se também de que os aplicativos COM+ que atualizam os dados não enviam atualizações para o Servidor Rastreador imediatamente, portanto, mesmo no melhor caso, haverá algum atraso (normalmente apenas alguns segundos).

A frequência de sondagem é uma política global que os administradores podem ajustar, se necessário, para equilibrar entre o frescor dos dados e o impacto no desempenho para o conjunto específico de ferramentas em uso nos sistemas que gerenciam. O valor retornado em PollingIntervalInSeconds é a quantidade mínima de tempo que um aplicativo deve aguardar depois de recuperar dados de rastreamento antes de fazer outra chamada para recuperar os mesmos dados. Qualquer aplicativo que sonda o Servidor Rastreador deve chamar esse método e ajustar seu comportamento de sondagem adequadamente.

O intervalo de sondagem é, por padrão, igual à frequência do evento de acompanhamento (três segundos). Esse valor pode ser ajustado escrevendo o seguinte REG_DWORD valor do Registro:

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3TrackingInfoPollingFrequency = intervalo mínimo de sondagem

Requisitos

Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	comsvcs.h

Confira também

IGetAppTrackerData