PdhVbAddCounter 함수

PdhVbAddCounter 함수는 지정된 쿼리 개체에 카운터 항목을 만들고 성공적으로 완료되면 해당 카운터에 대한 핸들을 반환합니다.

중요

이 항목에서 설명하는 함수는 나중에 변경되거나 사용할 수 없습니다. 대신 성능 카운터 함수에 설명된 함수를 사용하는 것이 좋습니다.

함수 PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath as String, _ ByVal CounterHandle As Long _ ) As Long

매개 변수

QueryHandle: 이 카운터를 할당할 쿼리의 ID입니다. 이 값은 PdhVbOpenQuery 함수에서 반환됩니다.
CounterPath: 쿼리에 추가할 카운터 경로의 이름을 지정하는 텍스트 문자열입니다. 이 문자열의 내용은 카운터 브라우저 또는 다른 원본에서 가져온 유효한 카운터 경로여야 합니다.
CounterHandle: 쿼리에서 이 카운터를 식별하는 고유 참조입니다. 함수가 호출되기 전에 이 변수를 0으로 초기화해야 합니다. 함수가 성공적으로 완료된 경우에만 반환에 유효한 값이 포함됩니다.

함수가 성공하면 ERROR_SUCCESS 같은 Long 정수와 CounterHandle 변수의 새 핸들을 반환합니다.

함수가 실패하면 반환 값은 시스템 오류 코드 또는 PDH 오류 코드입니다. 가능한 값은 다음과 같습니다.

반환 코드	설명
PDH_INVALID_ARGUMENT	하나 이상의 인수가 잘못되었거나 잘못되었습니다.
PDH_MEMORY_ALLOCATION_FAILURE	메모리 버퍼를 할당할 수 없습니다.
PDH_INVALID_HANDLE	쿼리 핸들이 잘못되었습니다.
PDH_CSTATUS_NO_COUNTER	지정된 카운터를 찾을 수 없습니다.
PDH_CSTATUS_NO_OBJECT	지정된 개체를 찾을 수 없습니다.
PDH_CSTATUS_NO_MACHINE	컴퓨터 항목을 만들 수 없습니다.
PDH_CSTATUS_BAD_COUNTERNAME	빈 카운터 이름 경로 문자열이 전달되었습니다.
PDH_FUNCTION_NOT_FOUND	이 카운터의 계산 함수를 확인할 수 없습니다.