PDH_COUNTER_INFO_A 구조체(pdh.h)

  • 아티클

PDH_COUNTER_INFO 구조에는 카운터의 속성을 설명하는 정보가 포함되어 있습니다. 이 정보에는 카운터 경로도 포함됩니다.

구문

typedef struct _PDH_COUNTER_INFO_A {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPSTR     szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_A   CounterPath;
    struct {
      LPSTR szMachineName;
      LPSTR szObjectName;
      LPSTR szInstanceName;
      LPSTR szParentInstance;
      DWORD dwInstanceIndex;
      LPSTR szCounterName;
    };
  };
  LPSTR     szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;

멤버

dwLength

추가된 문자열을 포함한 구조체의 크기(바이트)입니다.

dwType

카운터 유형입니다. 카운터 유형 목록은 Windows Server 2003 배포 키트의 카운터 형식 섹션을 참조하세요. 카운터 형식 상수는 Winperf.h에 정의됩니다.

CVersion

카운터 버전 정보입니다. 사용되지 않습니다.

CStatus

카운터 값이 유효한지 나타내는 카운터 상태. 가능한 값 목록은 PDH 인터페이스 반환 값 확인을 참조하세요.

lScale

카운터의 표시 가능한 값을 계산할 때 사용할 배율 인수입니다. 배율 인수는 10의 힘입니다. 이 매개 변수의 유효한 범위는 PDH_MIN_SCALE(–7)(반환된 값은 실제 값 시간 10~입니다)에서 PDH_MAX_SCALE(+7)(반환된 값은 실제 값 시간 10⁺입니다)입니다. 값이 0이면 크기 조정이 1로 설정되므로 실제 값이 반환됩니다.

lDefaultScale

카운터 공급자가 제안한 기본 배율 인수입니다.

dwUserData

PdhAddCounter를 호출할 때 dwUserData 매개 변수에 전달된 값입니다.

dwQueryUserData

PdhOpenQuery를 호출할 때 dwUserData 매개 변수에 전달된 값입니다.

szFullPath

전체 카운터 경로를 지정하는 Null로 끝나는 문자열입니다. 문자열은 메모리에서 이 구조를 따릅니다.

DataItemPath

PDH_DATA_ITEM_PATH_ELEMENTS 구조체입니다. 사용되지 않습니다.

CounterPath

PDH_COUNTER_PATH_ELEMENTS 구조체입니다.

szMachineName

카운터 경로에 지정된 컴퓨터의 이름을 포함하는 Null로 끝나는 문자열입니다. 경로가 컴퓨터를 지정하지 않는 경우 NULL입니다. 문자열은 메모리에서 이 구조를 따릅니다.

szObjectName

카운터 경로에 지정된 성능 개체의 이름을 포함하는 Null로 끝나는 문자열입니다. 문자열은 메모리에서 이 구조를 따릅니다.

szInstanceName

카운터 경로에 지정된 instance 개체의 이름을 포함하는 Null로 끝나는 문자열입니다. 경로가 instance 지정하지 않으면 NULL입니다. 문자열은 메모리에서 이 구조를 따릅니다.

szParentInstance

카운터 경로에 지정된 부모 instance 이름을 포함하는 Null로 끝나는 문자열입니다. 경로가 부모 instance 지정하지 않는 경우 NULL입니다. 문자열은 메모리에서 이 구조를 따릅니다.

dwInstanceIndex

카운터 경로에 지정된 인스턴스 인덱스입니다. 경로에서 instance 인덱스가 지정되지 않은 경우 0입니다.

szCounterName

카운터 이름을 포함하는 Null로 끝나는 문자열입니다. 문자열은 메모리에서 이 구조를 따릅니다.

szExplainText

카운터를 설명하는 도움말 텍스트입니다. 원본이 로그 파일인 경우 NULL 입니다.

DataBuffer[1]

구조체에 추가되는 문자열 데이터의 시작입니다.

설명

이 구조체에 대한 메모리를 할당할 때 이 구조체의 끝에 추가되는 szCounterName과 같은 멤버 문자열에 충분한 메모리를 할당합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 pdh.h

추가 정보

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo