PerfDeleteInstance 함수(perflib.h)

PerfCreateInstance 함수에서 만든 카운터 집합의 instance 삭제합니다. 공급자는 이 함수를 사용합니다.

구문

ULONG PerfDeleteInstance(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);

매개 변수

[in] Provider

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

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

[in] InstanceBlock

삭제할 카운터 집합의 instance 포함하는 PERF_COUNTERSET_INSTANCE 구조체입니다.

반환 값

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

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

설명

공급자 프로세스가 비정상적으로 종료되면 할당된 모든 인스턴스가 해제됩니다.

공급자는 instance 삭제하는 시기를 결정합니다. 카운터 데이터가 더 정적인 경우 공급자는 정리 시 instance 삭제할 수 있습니다. 예를 들어 컴퓨터의 프로세서 수는 정적으로 간주되므로 프로세서에 대한 카운터 데이터를 제공하는 공급자는 정리 시 컴퓨터의 각 프로세서에 대한 instance 삭제할 수 있습니다. 디스크 또는 프로세스 카운터와 같이 더 동적인 카운터의 경우 공급자는 제거되는 USB 디바이스 또는 프로세스가 종료되는 것에 대한 응답으로 인스턴스를 삭제합니다.

요구 사항

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

추가 정보

PerfCreateInstance

PerfQueryInstance