GetTimeSysInfoFunc 콜백 함수(timeprov.h)

시스템 시간 상태 정보를 검색합니다.

구문

GetTimeSysInfoFunc Gettimesysinfofunc;

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

매개 변수

[in] eInfo

요청된 상태 정보입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
TSI_ClockPrecision	pvInfo 매개 변수는 log2 초 단위로 클록 정밀도를 지정하는 부록 __int32 값입니다.
TSI_ClockTickSize	pvInfo 매개 변수는 (10^-7) 초 단위로 클록 틱 크기를 지정하는 부호 없는 __int64 값입니다.
TSI_CurrentTime	pvInfo 매개 변수는 1601년 1월 1일 오전 12:00 이후 경과된 (10^-7) 초 간격으로 현재 시간을 지정하는 서명되지 않은 __int64 값입니다( UTC).
TSI_LastSyncTime	pvInfo 매개 변수는 1601년 1월 1일 오전 12:00 이후 경과된 (10^-7) 초 간격에서 마지막 동기화 시간을 지정하는 부호 없는 __int64 값입니다(UTC).
TSI_LeapFlags	pvInfo 매개 변수는 임박한 윤초 또는 동기화 손실을 나타내는 BYTE 값입니다. 다음 값이 정의됩니다. 0 - 변경 없음 1 - 윤초 추가 2 - 윤초 빼기 3 - 동기화되지 않음
TSI_PhaseOffset	pvInfo 매개 변수는 클록을 조정하는 데 사용되는 위상 오프셋(초)을 지정하는 서명된 __int64 값입니다.
TSI_PollInterval	pvInfo 매개 변수는 로그2초 단위의 폴링 간격을 지정하는 서명된 __int32 값입니다.
TSI_ReferenceIdentifier	pvInfo 매개 변수는 시간 원본에 대한 참조 식별자를 NTP 형식(IP 주소 또는 GPS(Global Positioning System) 또는 WWVB와 같은 하드웨어 원본을 설명하는 4자 ASCII 문자열)로 지정하는 DWORD 값입니다.
TSI_RootDelay	pvInfo 매개 변수는 (10^-7) 초의 루트 지연을 지정하는 부호 있는 __int64 값입니다.
TSI_RootDispersion	pvInfo 매개 변수는 (10^-7) 초 안에 루트 분산을 지정하는 부호 없는 __int64 값입니다.
TSI_Stratum	pvInfo 매개 변수는 이 컴퓨터를 루트 원본과 분리하는 네트워크 홉 수를 지정하는 BYTE 값입니다. 하드웨어 공급자는 0을 반환해야 합니다. NTP 공급자는 샘플을 제공한 피어의 계층을 반환해야 합니다.
TSI_TickCount	pvInfo 매개 변수는 틱 수(시스템이 시작된 이후의 시간(밀리초))를 지정하는 부호 없는 __int64 값입니다. 이 값은 결국 래핑되므로 짧은 간격을 비교하는 데만 사용해야 합니다.
TSI_TSFlags	pvInfo 매개 변수는 다음 시간 원본 플래그 중 하나를 지정하는 DWORD 값입니다. TSF_Authenticated TSF_Hardware TSF_IPv6

[out] pvInfo

해당 상태 정보를 수신하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 eInfo 값에 따라 달라집니다.

반환 값

함수가 성공하면 반환 값이 S_OK. 그렇지 않으면 반환 값은 WinError.h에 정의된 오류 코드 중 하나입니다.

설명

정확도를 보장하기 위해 시간 공급자는 GetTimeSysInfoFunc를 사용하여 모든 시간 관련 정보를 검색해야 합니다. 시간 값은 NTP 패킷에서 직접 사용하면 안 됩니다. 1601년 1월 1일 오전 12:00에 상대적으로 표현되는 반면, NTP는 시간 값을 1900년 1월 1일 오전 12:00에 기준으로 표현하도록 지정합니다.

TimeProvOpen 함수는 이 함수에 대한 포인터를 반환합니다.

예제

예제는 샘플 시간 공급자를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	timeprov.h