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

추가 정보

PERF_COUNTER_IDENTIFIER

PerfAddCounters