GetSystemTimeAdjustmentPrecise 함수(sysinfoapi.h)

시스템이 주기적이고 프로그래밍된 시간 조정을 하루 중 시계에 적용하는지 여부를 결정하고 이러한 조정의 값과 기간을 얻습니다.

구문

BOOL GetSystemTimeAdjustmentPrecise(
  [out] PDWORD64 lpTimeAdjustment,
  [out] PDWORD64 lpTimeIncrement,
  [out] PBOOL    lpTimeAdjustmentDisabled
);

매개 변수

[out] lpTimeAdjustment

조정된 클록 업데이트 빈도를 반환합니다.

[out] lpTimeIncrement

클록 업데이트 빈도를 반환합니다.

[out] lpTimeAdjustmentDisabled

시간 조정을 사용할 수 있는지 여부를 지정하는 표시기를 반환합니다.

TRUE 값은 주기적 조정이 비활성화되었음을 나타냅니다. 이 경우 시스템은 자체 내부 메커니즘을 사용하여 하루 중 시간을 동기화 상태로 유지하려고 시도할 수 있습니다. 이로 인해 하루 중 시간이 주기적으로 "올바른 시간"으로 이동할 수 있습니다.

FALSE 값은 주기적이고 프로그래밍된 시간 조정이 하루 중 시간을 직렬화하는 데 사용되고 있으며 시스템이 자체적으로 시간을 방해하거나 동기화하려고 시도하지 않음을 나타냅니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 프로그래밍된 클록 조정을 사용하여 하루 중 시간을 다른 시간 원본과 동기화하는 알고리즘에서 사용됩니다. 이를 위해 시스템은 조정된 클록 업데이트 빈도를 계산한 다음, 이 함수를 통해 호출자가 해당 값을 가져올 수 있습니다.

참고  

시스템 시간 권한을 사용하도록 설정하고, 시스템 클록을 조정하고, 클록 값을 표시하는 방법에 대한 전체 코드 샘플 은 SetSystemTimeAdjustmentPrecise를 참조하세요.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	sysinfoapi.h
라이브러리	Mincore.lib
DLL	Api-ms-win-core-version-l1-2-3.dll

추가 정보

SetSystemTimeAdjustmentPrecise