PdhCollectQueryDataWithTime 함수(pdh.h)
지정된 쿼리의 모든 카운터에 대한 현재 원시 데이터 값을 수집하고 각 카운터의 상태 코드를 업데이트합니다.
구문
PDH_FUNCTION PdhCollectQueryDataWithTime(
[in, out] PDH_HQUERY hQuery,
[out] LONGLONG *pllTimeStamp
);
매개 변수
[in, out] hQuery
데이터를 수집하려는 쿼리의 핸들입니다. PdhOpenQuery 함수는 이 핸들을 반환합니다.
[out] pllTimeStamp
쿼리의 첫 번째 카운터 값을 검색할 때 타임스탬프를 지정합니다. 시간은 FILETIME으로 지정됩니다.
반환 값
함수가 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 함수는 시스템 오류 코드 또는 PDH 오류 코드를 반환합니다.
가능한 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
쿼리 핸들이 잘못되었습니다. |
|
쿼리에는 현재 카운터가 없습니다. |
설명
쿼리의 카운터에 대한 카운터 데이터를 수집하려는 경우 이 함수를 호출합니다. PDH는 현재 및 이전 컬렉션에 대한 원시 카운터 값을 저장합니다.
현재 원시 카운터 값을 검색하려면 PdhGetRawCounterValue 함수를 호출합니다. 카운터 값에 대해 표시 가능한 값을 계산하려면 PdhGetFormattedCounterValue를 호출합니다. 카운터 경로에 instance 이름에 대한 와일드카드가 포함된 경우 PdhGetRawCounterArray 및 PdhGetFormattedCounterArray 함수를 각각 호출합니다.
PdhCollectQueryDataEx가 하나의 카운터 instance 데이터에 대해서만 호출되고 카운터 instance 없는 경우 함수는 PDH_NO_DATA 반환합니다. 그러나 둘 이상의 카운터에서 데이터를 쿼리하는 경우 PdhCollectQueryDataEx 는 카운터 인스턴스 중 하나가 아직 없는 경우에도 ERROR_SUCCESS 반환할 수 있습니다. 이는 지정된 카운터 instance 없는지 또는 이 카운터가 존재하지만 아직 만들어지지 않은지 알 수 없기 때문입니다. 이 경우 관심 있는 각 카운터 인스턴스에 대해 PdhGetRawCounterValue 또는 PdhGetFormattedCounterValue 함수를 호출하여 존재하는지 여부를 확인합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | pdh.h |
| 라이브러리 | Pdh.lib |
| DLL | Pdh.dll |