PerfDeleteCounters 함수(perflib.h)
지정된 쿼리에서 지정된 성능 카운터 사양을 제거합니다.
구문
ULONG PerfDeleteCounters(
[in] HANDLE hQuery,
[in, out] PPERF_COUNTER_IDENTIFIER pCounters,
DWORD cbCounters
);
매개 변수
[in] hQuery
성능 카운터 사양을 제거하려는 쿼리에 대한 핸들입니다.
[in, out] pCounters
제거하려는 성능 카운터 사양에 대한 포인터입니다.
cbCounters
pCounters 매개 변수가 지정하는 버퍼의 크기(바이트)입니다.
반환 값
함수가 성공하면 ERROR_SUCCESS 반환합니다.
함수가 실패하면 반환 값은 시스템 오류 코드입니다.
설명
pCounters 매개 변수는 PERF_COUNTER_IDENTIFIER 블록 시퀀스를 가리킵니다. 각 PERF_COUNTER_IDENTIFIER 블록은 PERF_COUNTER_IDENTIFIER 구조체로 구성되며, 필요에 따라 null로 끝나는 UTF-16LE instance 이름 문자열과 블록의 크기를 8바이트의 배수로 만드는 패딩으로 구성됩니다.
PerfAddCounters에 대한 설명에 설명된 것과 동일한 방식으로 각 PERF_COUNTER_IDENTIFIER 블록을 구성합니다.
PerfDeleteCounters는 각 PERF_COUNTER_IDENTIFIER 블록에 대한 쿼리에서 하나의 카운터 사양을 제거하려고 시도하고 각 블록의 PERF_COUNTER_IDENTIFIER 구조체의 Status 멤버를 시도 결과로 업데이트합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 10 버전 1607 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | perflib.h |
| 라이브러리 | AdvAPI32.lib |
| DLL | AdvAPI32.dll |