PerfQueryInstance 함수(perflib.h)

지정된 카운터 집합 instance 대한 포인터를 검색합니다. 공급자는 이 함수를 사용합니다.

구문

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

매개 변수

[in] ProviderHandle

공급자의 핸들입니다. CTRPP 도구가 생성한 핸들 변수를 사용합니다. 변수의 이름은 공급자 요소의 기호 특성을 참조하세요.

Windows Vista: PerfStartProvider 함수는 핸들을 반환합니다.

[in] CounterSetGuid

쿼리하려는 카운터 집합을 고유하게 식별하는 GUID입니다. counterSet 요소의 guid 특성에 지정된 것과 동일한 GUID입니다. CTRPP 도구가 생성한 GUID 변수를 사용합니다. 변수의 이름은 counterSet 요소의 기호 특성을 참조하세요.

Windows Vista: GUID 변수를 사용할 수 없습니다.

[in] Name

검색하려는 카운터 집합 instance 이름이 포함된 Null로 종료된 유니코드 문자열입니다.

[in] Id

검색하려는 카운터 집합 instance 고유 식별자입니다.

반환 값

instance 없는 경우 카운터 집합 instance 또는 NULL을 포함하는 PERF_COUNTERSET_INSTANCE 구조체입니다.

오류가 발생한 경우 이 함수는 NULL 을 반환합니다. 발생한 오류를 확인하려면 GetLastError를 호출합니다.

설명

PerfCreateInstance를 호출할 때 사용한 것과 동일한 instance 이름 및 식별자를 사용하여 카운터 집합의 특정 instance 검색합니다.

공급자는 포인터를 검색하기 위해 이 함수를 호출하는 대신 instance 만들 때 instance 대한 포인터를 캐시해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	perflib.h
라이브러리	Advapi32.lib
DLL	Advapi32.dll

추가 정보

PerfCreateInstance