Función TimeProvCommand (timeprov.h)

Función de devolución de llamada a la que llama el administrador del proveedor de tiempo para enviar comandos al proveedor de hora.

Sintaxis

HRESULT TimeProvCommand(
  [in] TimeProvHandle hTimeProv,
  [in] TimeProvCmd    eCmd,
  [in] TimeProvArgs   pvArgs
);

Parámetros

[in] hTimeProv

Identificador del proveedor de hora. La función TimeProvOpen recibe este identificador.

[in] eCmd

Comando que se va a enviar. Este parámetro puede ser uno de los valores siguientes.

Get-Help	Significado
TPC_GetSamples	El proveedor de hora debe devolver las muestras de tiempo que ha recopilado. Si no hay datos disponibles, el proveedor no debe devolver ningún ejemplo. Para obtener más información, consulte Comentarios. El parámetro pvArgs es puntero a una estructura TpcGetSamplesArgs . El administrador de proveedores de tiempo proporciona el búfer para los ejemplos. Si el búfer pvArgs es demasiado pequeño, el proveedor debe proporcionar tantas muestras como sea posible y devolver ERROR_INSUFFICIENT_BUFFER. Se omite cualquier otro código de error devuelto por el proveedor.
TPC_NetTopoChange	La topología de red ha cambiado. Los proveedores de red deben volver a detectar la configuración de red y comprobar que pueden llegar a sus orígenes. El parámetro pvArgs indica si el usuario (NTC_UserRequested) solicitó el cambio o el sistema (NTC_Default).
TPC_Query	Reservado para uso futuro.
TPC_PollIntervalChanged	El intervalo de sondeo ha cambiado. El proveedor de hora debe llamar a la función GetTimeSysInfo para recuperar el nuevo valor. No se usa el parámetro pvArgs . Se omite cualquier error devuelto por el proveedor.
TPC_Shutdown	El sistema se está apagando. El proveedor de hora debe salir en un plazo de cinco segundos. No se usa el parámetro pvArgs .
TPC_TimeJumped	El reloj del sistema se ajustó abruptamente, por lo que el proveedor de hora debe descartar cualquier marca de tiempo que haya guardado. El parámetro pvArgs indica si el usuario solicitó el salto de tiempo (TJF_UserRequested) o el sistema (TJF_Default).
TPC_UpdateConfig	El proveedor de hora debe comprobar si los datos de configuración específicos de la aplicación almacenados en el registro han cambiado. No se usa el parámetro pvArgs . Se omite cualquier error devuelto por el proveedor.

[in] pvArgs

Puntero a un búfer que especifica información de comandos. El formato de estos datos depende del valor de eCmd.

Valor devuelto

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

Comentarios

El proveedor de tiempo nunca debe tardar más de medio segundo en volver de esta llamada.

Al procesar el comando TPC_GetSamples, el proveedor debe devolver un ejemplo para cada origen que está supervisando. Por lo tanto, un proveedor de hardware debe devolver un ejemplo, mientras que un proveedor de red como NTP puede devolver varias muestras. El proveedor no debe devolver varias muestras de un único origen; debe devolver el mejor ejemplo de su memoria caché de muestras para el origen. El proveedor puede devolver el mismo ejemplo en las llamadas posteriores, siempre que los datos no hayan cambiado.

Ejemplos

Para obtener un ejemplo, vea 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

Consulte también

GetTimeSysInfoFunc

TimeProvOpen

TpcGetSamplesArgs