PerfOpenQueryHandle 함수(perflib.h)

아티클
03/01/2024

지정된 시스템에서 쿼리를 참조하는 핸들을 만듭니다. 쿼리는 카운터 사양의 목록입니다.

구문

ULONG PerfOpenQueryHandle(
  [in, optional] LPCWSTR szMachine,
  [out]          HANDLE  *phQuery
);

매개 변수

[in, optional] szMachine

쿼리 핸들을 가져올 컴퓨터의 이름입니다.

[out] phQuery

쿼리에 대한 핸들입니다. PerfCloseQueryHandle을 호출하여 더 이상 필요하지 않은 경우 ths 핸들을 닫습니다.

반환 값

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

함수가 실패하면 반환 값은 시스템 오류 코드입니다.

설명

PerfAddCounters 및 PerfDeleteCounters를 사용하여 목록에 카운터 사양을 추가하거나 제거합니다. PerfQueryCounterInfo를 사용하여 현재 목록에 있는 카운터 사양을 가져오고 PerfQueryCounterData에서 각 카운터의 데이터를 반환할 인덱스를 결정합니다. PerfQueryCounterData를 사용하여 카운터 사양과 일치하는 카운터의 값을 검색합니다.

요구 사항

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