다음을 통해 공유

PdhCollectQueryData 함수(pdh.h)

  • 아티클

지정된 쿼리의 모든 카운터에 대한 현재 원시 데이터 값을 수집하고 각 카운터의 상태 코드를 업데이트합니다.

구문

PDH_FUNCTION PdhCollectQueryData(
  [in, out] PDH_HQUERY hQuery
);

매개 변수

[in, out] hQuery

데이터를 수집하려는 쿼리의 핸들입니다. PdhOpenQuery 함수는 이 핸들을 반환합니다.

반환 값

함수가 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 함수는 시스템 오류 코드 또는 PDH 오류 코드를 반환합니다.

가능한 값은 다음과 같습니다.

반환 코드 설명
PDH_INVALID_HANDLE
 쿼리 핸들이 잘못되었습니다.
PDH_NO_DATA
 쿼리에는 현재 카운터가 포함되어 있지 않습니다. 사용자가 관리자 권한 토큰으로 실행되고 있지 않기 때문에 쿼리에 데이터가 포함되지 않을 수 있습니다( 제한된 사용자 액세스 지원 참조).

설명

쿼리에서 카운터에 대한 카운터 데이터를 수집하려는 경우 이 함수를 호출합니다. PDH는 현재 및 이전 컬렉션에 대한 원시 카운터 값을 저장합니다.

현재 원시 카운터 값을 검색하려면 PdhGetRawCounterValue 함수를 호출합니다. 카운터 값에 대해 표시 가능한 값을 계산하려면 PdhGetFormattedCounterValue 함수를 호출합니다. 카운터 경로에 instance 이름에 대한 와일드카드가 포함된 경우 PdhGetRawCounterArray 및 PdhGetFormattedCounterArray 함수를 각각 호출합니다.

PdhCollectQueryData가 하나의 카운터 instance 데이터에 대해서만 호출되고 카운터 instance 존재하지 않는 경우 함수는 PDH_NO_DATA 반환합니다. 그러나 둘 이상의 카운터의 데이터를 쿼리하는 경우 카운터 인스턴스 중 하나가 아직 없더라도 PdhCollectQueryData 는 ERROR_SUCCESS 반환할 수 있습니다. 이는 지정된 카운터 instance 존재하지 않는지 또는 이 카운터가 존재하지만 아직 만들어지지 않은지 알 수 없기 때문입니다. 이 경우 관심 있는 각 카운터 인스턴스에 대해 PdhGetRawCounterValue 또는 PdhGetFormattedCounterValue 를 호출하여 해당 인스턴스가 있는지 확인합니다.

다음은 Visual Basic에서 이 함수를 호출하는 경우 구문을 보여줍니다.

PdhCollectQueryData(
  ByVal QueryHandle as Long  
)
as Long

예제

예를 들어 성능 카운터 찾아보기 또는 로그 파일에서 성능 데이터 읽기를 참조하세요.

요구 사항

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

추가 정보

PdhGetFormattedCounterValue

PdhGetRawCounterValue