TimeProvCommand 函式 (timeprov.h)

由時間提供者管理員呼叫的回呼函式，以將命令傳送至時間提供者。

語法

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

[in] hTimeProv

時間提供者的句柄。 TimeProvOpen 函式會收到此句柄。

[in] eCmd

要傳送的命令。此參數可以是下列其中一個值。

命令	意義
TPC_GetSamples	時間提供者應該會傳回所收集的時間樣本。如果沒有可用的數據，提供者應該不會傳回任何樣本。如需詳細資訊，請參閱備註。 pvArgs 參數是 TpcGetSamplesArgs 結構的指標。時間提供者管理員會提供範例的緩衝區。如果 pvArgs 緩衝區太小，提供者應該盡可能提供許多樣本，並傳回ERROR_INSUFFICIENT_BUFFER。提供者傳回的任何其他錯誤碼都會被忽略。
TPC_NetTopoChange	網路拓撲已變更。網路提供者必須重新偵測網路設定，並確認它們可以連線到其來源。 pvArgs 參數會指出使用者 (NTC_UserRequested) 要求變更，還是系統 (NTC_Default) 。
TPC_Query	保留供未來使用。
TPC_PollIntervalChanged	輪詢間隔已變更。時間提供者應該呼叫 GetTimeSysInfo 函式來擷取新的值。不會使用 pvArgs 參數。提供者傳回的任何錯誤都會被忽略。
TPC_Shutdown	系統正在關閉。時間提供者應該會在五秒內結束。不會使用 pvArgs 參數。
TPC_TimeJumped	系統時鐘突然調整，因此時間提供者應該捨棄它已儲存的任何時間戳。 pvArgs 參數會指出使用者 (TJF_UserRequested) 還是系統 (TJF_Default) 要求時間跳躍。
TPC_UpdateConfig	時間提供者應該確認其儲存在登錄中的應用程式特定設定數據是否已變更。不會使用 pvArgs 參數。提供者傳回的任何錯誤都會被忽略。

[in] pvArgs

指定命令信息的緩衝區指標。此數據的格式取決於 eCmd 的值。

如果函式成功，傳回值會S_OK。否則，傳回值是 WinError.h 中定義的其中一個錯誤碼。

時間提供者應該永遠不會花費超過半秒的時間，才能從這個呼叫傳回。

處理TPC_GetSamples命令時，提供者應該針對監視的每個來源傳回一個範例。因此，硬體提供者應該會傳回一個範例，而 NTP 之類的網路提供者可以傳回多個範例。提供者不應該從單一來源傳回多個樣本;它應該會從來源的樣本快取中傳回最佳樣本。提供者可以在後續呼叫時傳回相同的範例，前提是數據尚未變更。

如需範例，請參閱範例時間提供者。