Compartir a través de

Función de devolución de llamada GetTimeSysInfoFunc (timeprov.h)

  • Artículo

Recupera la información de estado de hora del sistema.

Sintaxis

GetTimeSysInfoFunc Gettimesysinfofunc;

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

Parámetros

[in] eInfo

Información de estado solicitada. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
TSI_ClockPrecision
 El parámetro pvInfo es un valor de __int32 firmado que especifica la precisión del reloj, en log2 segundos.
TSI_ClockTickSize
 El parámetro pvInfo es un valor de __int64 sin signo que especifica el tamaño del tic del reloj, en (10^-7) segundos.
TSI_CurrentTime
 El parámetro pvInfo es un valor de __int64 sin signo que especifica la hora actual, en (10^-7) intervalos de segundo que han transcurrido desde las 12:00 A.M. 1 de enero de 1601 Hora universal coordinada (UTC).
TSI_LastSyncTime
 El parámetro pvInfo es un valor de __int64 sin signo que especifica la hora de la última sincronización, en (10^-7) segundos intervalos transcurridos desde las 12:00 A.M. 1 de enero de 1601 Hora universal coordinada (UTC).
TSI_LeapFlags
 El parámetro pvInfo es un valor BYTE que indica un segundo salto inminente o una pérdida de sincronización. Se definen los valores siguientes:
0 - Sin cambio
1 - Agregar segundo salto
2 - Restar segundo salto
3 - No sincronizado
TSI_PhaseOffset
 El parámetro pvInfo es un valor de __int64 con signo que especifica el desplazamiento de fase usado para ajustar el reloj, en segundos.
TSI_PollInterval
 El parámetro pvInfo es un valor de __int32 firmado que especifica el intervalo de sondeo, en log2 segundos.
TSI_ReferenceIdentifier
 El parámetro pvInfo es un valor DWORD que especifica el identificador de referencia para el origen de hora, en formato NTP (una dirección IP o una cadena ASCII de cuatro caracteres que describe el origen de hardware, como el Sistema de posicionamiento global (GPS) o WWVB).
TSI_RootDelay
 El parámetro pvInfo es un valor de __int64 con signo que especifica el retraso raíz, en (10^-7) segundos.
TSI_RootDispersion
 El parámetro pvInfo es un valor de __int64 sin signo que especifica, la dispersión raíz, en (10^-7) segundos.
TSI_Stratum
 El parámetro pvInfo es un valor BYTE que especifica el número de saltos de red que separan este equipo del origen raíz. Los proveedores de hardware deben devolver cero. Los proveedores NTP deben devolver el estrato del mismo nivel que proporcionó el ejemplo.
TSI_TickCount
 El parámetro pvInfo es un valor de __int64 sin signo que especifica el recuento de tics (número de milisegundos desde que se inició el sistema). Este valor finalmente se ajustará, por lo que solo se debe usar para comparar intervalos cortos.
TSI_TSFlags
 El parámetro pvInfo es un valor DWORD que especifica una de las siguientes marcas de origen de hora:
TSF_Authenticated
TSF_Hardware
TSF_IPv6

[out] pvInfo

Puntero a un búfer que recibe esa información de estado. El formato de estos datos depende del valor de eInfo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se S_OK. De lo contrario, el valor devuelto es uno de los códigos de error definidos en WinError.h.

Comentarios

Para garantizar la precisión, el proveedor de hora debe recuperar toda la información relacionada con el tiempo mediante GetTimeSysInfoFunc. Tenga en cuenta que los valores de hora no deben usarse directamente en un paquete NTP. Se expresan en relación con las 12:00 A.M. 1 de enero de 1601, mientras que NTP especifica que los valores de hora se expresan en relación con las 12:00 A.M. 1 de enero de 1900.

La función TimeProvOpen devuelve un puntero a esta función.

Ejemplos

Para obtener un ejemplo, consulte Proveedor de hora de ejemplo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado timeprov.h