PdhSetQueryTimeRange 함수(pdh.h)

로그 파일에서 읽을 수 있는 샘플을 지정된 시간 범위 내의 샘플로 제한합니다.

구문

PDH_FUNCTION PdhSetQueryTimeRange(
  [in] PDH_HQUERY     hQuery,
  [in] PPDH_TIME_INFO pInfo
);

[in] hQuery

쿼리에 대한 핸들입니다. PdhOpenQuery 함수는 이 핸들을 반환합니다.

[in] pInfo

시간 범위를 지정하는 PDH_TIME_INFO 구조체입니다. 시간을 로컬 파일 시간으로 지정합니다. 종료 시간은 시작 시간보다 커야 합니다. 모든 레코드를 읽으려는 경우 시작 시간에 대해 0을 지정하고 종료 시간에 대한 최대 64비트 값을 지정할 수 있습니다.

함수가 성공하면 ERROR_SUCCESS 반환합니다.

함수가 실패하면 반환 값은 시스템 오류 코드 또는 PDH 오류 코드입니다. 가능한 값은 다음과 같습니다.

반환 코드	설명
PDH_INVALID_HANDLE	쿼리 핸들이 잘못되었습니다.
PDH_INVALID_ARGUMENT	끝 시간 범위 값은 시작 시간 범위 값보다 커야 합니다.

지정된 시간 범위의 끝 또는 로그 파일의 끝에 도달하면 PdhCollectQueryData 함수는 PDH_NO_MORE_DATA 반환합니다.