Compartilhar via

Função de retorno de chamada GetTimeSysInfoFunc (timeprov.h)

  • Artigo

Recupera as informações de estado de hora do sistema.

Sintaxe

GetTimeSysInfoFunc Gettimesysinfofunc;

HRESULT Gettimesysinfofunc(
  [in]  TimeSysInfo eInfo,
  [out] void *pvInfo
)
{...}

Parâmetros

[in] eInfo

Informações de estado solicitadas. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
TSI_ClockPrecision
 O parâmetro pvInfo é um valor __int32 assinado que especifica a precisão do relógio, em log2 segundos.
TSI_ClockTickSize
 O parâmetro pvInfo é um valor de __int64 sem sinal que especifica o tamanho do tique do relógio, em (10^-7) segundos.
TSI_CurrentTime
 O parâmetro pvInfo é um valor de __int64 sem sinal que especifica a hora atual, em intervalos de (10^-7) segundos decorridos desde 12:00 DA.M. 1º de janeiro de 1601 UTC (Tempo Universal Coordenado).
TSI_LastSyncTime
 O parâmetro pvInfo é um valor de __int64 sem sinal que especifica a hora da última sincronização, em intervalos (10^-7) segundos decorridos desde 12:00 DA.M. 1º de janeiro de 1601 UTC (Tempo Universal Coordenado).
TSI_LeapFlags
 O parâmetro pvInfo é um valor BYTE que indica um segundo bissexto iminente ou perda de sincronização. Os seguintes valores são definidos:
0 - Nenhuma alteração
1 - Adicionar segundo bissexto
2 – Subtrair segundo bissexto
3 – Não sincronizado
TSI_PhaseOffset
 O parâmetro pvInfo é um valor __int64 assinado que especifica o deslocamento de fase usado para ajustar o relógio, em segundos.
TSI_PollInterval
 O parâmetro pvInfo é um valor __int32 assinado que especifica o intervalo de sondagem, em log2 segundos.
TSI_ReferenceIdentifier
 O parâmetro pvInfo é um valor DWORD que especifica o identificador de referência para a fonte de tempo, no formato NTP (um endereço IP ou uma cadeia de caracteres ASCII de quatro caracteres que descreve a fonte de hardware, como GPS (Sistema de Posicionamento Global) ou WWVB).
TSI_RootDelay
 O parâmetro pvInfo é um valor __int64 assinado que especifica o atraso raiz, em (10^-7) segundos.
TSI_RootDispersion
 O parâmetro pvInfo é um valor de __int64 sem sinal que especifica, a dispersão raiz, em (10^-7) segundos.
TSI_Stratum
 O parâmetro pvInfo é um valor BYTE que especifica o número de saltos de rede que separam esse computador da origem raiz. Os provedores de hardware devem retornar zero. Os provedores NTP devem retornar o estrato do par que forneceu o exemplo.
TSI_TickCount
 O parâmetro pvInfo é um valor __int64 sem sinal que especifica a contagem de tiques (número de milissegundos desde que o sistema foi iniciado). Esse valor eventualmente será encapsulado, portanto, ele deve ser usado apenas para comparar intervalos curtos.
TSI_TSFlags
 O parâmetro pvInfo é um valor DWORD que especifica um dos seguintes sinalizadores de origem de hora:
TSF_Authenticated
TSF_Hardware
TSF_IPv6

[out] pvInfo

Um ponteiro para um buffer que recebe essas informações de estado. O formato desses dados depende do valor de eInfo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será S_OK. Caso contrário, o valor retornado será um dos códigos de erro definidos em WinError.h.

Comentários

Para garantir a precisão, o provedor de tempo deve recuperar todas as informações relacionadas ao tempo usando GetTimeSysInfoFunc. Observe que os valores de hora não devem ser usados diretamente em um pacote NTP. Eles são expressos em relação às 12:00 da manhã de 1º de janeiro de 1601, enquanto o NTP especifica que os valores de hora sejam expressos em relação às 00:00 de 1º de janeiro de 1900.

A função TimeProvOpen retorna um ponteiro para essa função.

Exemplos

Para obter um exemplo, consulte Provedor de Tempo de Exemplo.

Requisitos

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