GetSystemTimeAdjustment 함수(sysinfoapi.h)

  • 아티클

시스템이 정기적인 시간 조정을 하루 중 시계에 적용하는지 여부를 결정하고 이러한 조정의 값과 기간을 가져옵니다.

구문

BOOL GetSystemTimeAdjustment(
  [out] PDWORD lpTimeAdjustment,
  [out] PDWORD lpTimeIncrement,
  [out] PBOOL  lpTimeAdjustmentDisabled
);

매개 변수

[out] lpTimeAdjustment

함수가 100나노초 단위의 수 로 설정하는 변수에 대한 포인터로, 실제로 시스템에서 계산된 대로 전달되는 모든 기간 동안 시간 시계에 추가됩니다. 이 값은 lpTimeAdjustmentDisabled 가 FALSE인 경우에만 의미가 있습니다.

[out] lpTimeIncrement

함수가 100나노초 단위의 간격으로 설정하는 변수에 대한 포인터로, 시스템에서 시간 시계에 lpTimeAdjustment 를 추가합니다. 이 값은 lpTimeAdjustmentDisabled 가 FALSE인 경우에만 의미가 있습니다.

[out] lpTimeAdjustmentDisabled

주기적인 시간 조정이 적용되는지 여부를 나타내기 위해 함수가 설정하는 변수에 대한 포인터입니다.

TRUE 값은 주기적 시간 조정이 비활성화되고 시스템 시간/일 시계가 정상 속도로 진행됨을 나타냅니다. 이 모드에서 시스템은 자체 내부 시간 동기화 메커니즘을 사용하여 하루 중 시간을 조정할 수 있습니다. 이러한 내부 시간 동기화 메커니즘으로 인해 시스템 작업의 정상적인 과정에서 하루 중 시계가 변경될 수 있으며, 이는 시스템에서 필요하다고 판단되는 시간에 눈에 띄는 점프를 포함할 수 있습니다.

FALSE 값은 주기적인 시간 조정을 사용하여 시간/시간 시계를 조정하고 있음을 나타냅니다. 실제로 통과하는 각 lpTimeIncrement 기간에 대해 lpTimeAdjustment 가 하루 중 시간에 추가됩니다. lpTimeAdjustment 값이 lpTimeIncrement보다 작으면 시스템 시간/일 시계가 평소보다 느린 속도로 진행됩니다. lpTimeAdjustment 값이 lpTimeIncrement보다 크면 시간 시계가 평소보다 빠르게 진행됩니다. lpTimeAdjustment가 lpTimeIncrement와 같으면 시간 시계가 정상 속도로 진행됩니다. lpTimeAdjustment 값은 SetSystemTimeAdjustment를 호출하여 설정할 수 있습니다. lpTimeIncrement 값은 시작 시 시스템에서 수정되며 시스템 작업 중에는 변경되지 않습니다. 이 모드에서는 시스템이 시간 조정 체계를 방해하지 않으며 다른 기술을 통해 하루 중 시간을 자체적으로 동기화하려고 시도하지 않습니다.

반환 값

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

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

설명

GetSystemTimeAdjustment 및 SetSystemTimeAdjustment 함수를 사용하여 GetSystemTime 및 GetLocalTime에서 보고한 하루 중 시간 시계를 동기화하려는 알고리즘을 주기적인 시간 조정을 사용하여 다른 시간 원본과 동기화할 수 있습니다.

GetSystemTimeAdjustment 함수를 사용하면 호출자가 주기적인 시간 조정을 사용할 수 있는지 여부를 확인하고, 이 경우 각 조정의 양과 조정 사이의 시간을 얻을 수 있습니다. SetSystemTimeAdjustment 함수를 사용하면 호출자가 주기적인 시간 조정을 사용하거나 사용하지 않도록 설정하고 조정 증분 값을 설정할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 sysinfoapi.h(Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

GetLocalTime

GetSystemTime

SetSystemTimeAdjustment

시스템 시간

시간 함수