PDH_BROWSE_DLG_CONFIG_HW 구조체(pdh.h)

아티클
08/25/2023

PDH_BROWSE_DLG_CONFIG_H 구조는 PdhBrowseCountersH 함수에서 성능 카운터 찾아보기 대화 상자를 구성하는 데 사용됩니다.

구문

typedef struct _BrowseDlgConfig_HW {
  DWORD               bIncludeInstanceIndex : 1;
  DWORD               bSingleCounterPerAdd : 1;
  DWORD               bSingleCounterPerDialog : 1;
  DWORD               bLocalCountersOnly : 1;
  DWORD               bWildCardInstances : 1;
  DWORD               bHideDetailBox : 1;
  DWORD               bInitializePath : 1;
  DWORD               bDisableMachineSelection : 1;
  DWORD               bIncludeCostlyObjects : 1;
  DWORD               bShowObjectBrowser : 1;
  DWORD               bReserved : 22;
  HWND                hWndOwner;
  PDH_HLOG            hDataSource;
  LPWSTR              szReturnPathBuffer;
  DWORD               cchReturnPathLength;
  CounterPathCallBack pCallBack;
  DWORD_PTR           dwCallBackArg;
  PDH_STATUS          CallBackStatus;
  DWORD               dwDefaultDetailLevel;
  LPWSTR              szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_HW, *PPDH_BROWSE_DLG_CONFIG_HW;

멤버

bIncludeInstanceIndex

이 플래그가 TRUE이면 대화 상자에 중복 instance 이름의 인덱스 번호가 포함됩니다. 예를 들어 두 cmd 인스턴스가 있는 경우 instance 목록에 cmd 및 cmd#1이 포함됩니다. 이 플래그가 FALSE이면 중복 instance 이름에 인덱스 번호가 포함되지 않습니다.

bSingleCounterPerAdd

이 플래그가 TRUE이면 대화 상자는 하나의 카운터만 반환합니다. 이 플래그가 FALSE이면 대화 상자에서 여러 선택 항목을 반환할 수 있으며 와일드카드 선택 항목이 허용됩니다. 선택한 카운터는 MULTI_SZ 문자열로 반환됩니다.

bSingleCounterPerDialog

이 플래그가 TRUE이면 대화 상자에서 확인 및 취소 단추를 사용합니다. 대화 상자는 사용자가 두 단추 중 하나를 클릭하면 반환됩니다. 이 플래그가 FALSE이면 대화 상자에서 추가 및 닫기 단추를 사용합니다. 사용자가 닫기 단추를 클릭하면 대화 상자가 닫힙니다. 추가 단추를 여러 번 클릭할 수 있습니다. 추가 단추는 이전에 선택한 항목을 현재 선택한 항목으로 덮어씁니다.

bLocalCountersOnly

이 플래그가 TRUE이면 대화 상자에서 사용자가 로컬 컴퓨터에서만 카운터를 선택할 수 있습니다(경로에 컴퓨터 이름이 포함되지 않음). 이 플래그가 FALSE이면 사용자는 카운터를 선택할 컴퓨터를 지정할 수 있습니다. 컴퓨터 이름은 사용자가 로컬 컴퓨터 카운터 사용을 선택하지 않는 한 카운터 경로의 접두사를 지정합니다.

bWildCardInstances

이 플래그가 TRUE이고 사용자가 모든 인스턴스를 선택하면 카운터 경로에 instance 필드의 와일드카드 문자가 포함됩니다.

이 플래그가 FALSE이고 사용자가 모든 인스턴스를 선택하면 해당 개체에 대해 현재 찾은 모든 인스턴스가 MULTI_SZ 문자열에 반환됩니다.

bHideDetailBox

이 플래그가 TRUE이면 대화 상자에서 세부 정보 수준이 제거되므로 사용자가 대화 상자에 표시되는 카운터의 세부 수준을 변경할 수 없습니다. 세부 정보 수준은 dwDefaultDetailLevel 멤버의 값으로 고정됩니다.

이 플래그가 FALSE이면 대화 상자에 세부 정보 수준이 표시되므로 사용자가 표시되는 카운터의 세부 정보 수준을 변경할 수 있습니다.

표시되는 카운터는 세부 정보 수준이 현재 세부 정보 수준 선택 영역보다 작거나 같은 카운터입니다. 마법사의 세부 수준을 선택하면 모든 카운터와 개체가 표시됩니다.

bInitializePath

이 플래그가 TRUE이면 대화 상자가 처음 표시될 때 컴퓨터에서 지정한 기본 카운터와 개체를 사용하는 대신 szReturnPathBuffer 에 지정된 카운터와 개체가 강조 표시됩니다.

이 플래그가 FALSE이면 컴퓨터에서 반환하는 기본 카운터 및 개체 정보를 사용하여 초기 카운터 및 개체를 선택합니다.

bDisableMachineSelection

이 플래그가 TRUE이면 컴퓨터에서 카운터 선택에서 컴퓨터를 선택할 수 없습니다.

이 플래그가 FALSE이면 컴퓨터에서 카운터 선택에서 컴퓨터를 선택할 수 있습니다. 이것은 기본값입니다. 목록에는 PdhConnectMachine 을 호출하여 다른 컴퓨터에 먼저 연결하지 않는 경우에만 로컬 컴퓨터가 포함됩니다.

bIncludeCostlyObjects

이 플래그가 TRUE이면 카운터 목록에는 비용이 많이 드는 데이터, 즉 상대적으로 많은 양의 프로세서 시간 또는 메모리 오버헤드를 수집해야 하는 데이터도 포함됩니다.

이 플래그가 FALSE이면 목록에 비용이 많이 드는 카운터가 포함되지 않습니다. 이것은 기본값입니다.

bShowObjectBrowser

이 플래그가 TRUE이면 대화 상자에 성능 개체만 나열됩니다. 사용자가 개체를 선택하면 개체가 여러 instance 개체인 경우 instance 이름 및 카운터에 대한 개체 및 와일드카드 문자가 포함된 카운터 경로가 반환됩니다. 예를 들어 "Process" 개체를 선택하면 대화 상자에서 "\Process(*)*" 문자열을 반환합니다. 개체가 단일 instance 개체인 경우 경로에는 카운터에 대한 와일드카드 문자만 포함됩니다. 예를 들어 "\System*"입니다. 그런 다음 PdhExpandWildCardPath 에 경로를 전달하여 개체의 실제 경로 목록을 검색할 수 있습니다.

bReserved

hWndOwner

대화 상자를 소유할 창의 핸들입니다. NULL인 경우 소유자는 바탕 화면입니다.

hDataSource

PdhBindInputDataSource 함수에서 반환된 데이터 원본에 대한 핸들입니다.

szReturnPathBuffer

선택한 카운터 경로가 포함된 MULTI_SZ 대한 포인터입니다.

bInitializePath가 TRUE인 경우 이 멤버를 사용하여 대화 상자가 처음 표시될 때 컴퓨터, 개체, 카운터 및 instance 목록의 항목을 강조 표시하는 데 구성 요소가 사용되는 카운터 경로를 지정할 수 있습니다.

cchReturnPathLength

TCHAR에서 szReturnPathBuffer 버퍼의 크기입니다. 콜백 함수가 새 버퍼를 다시 할당하는 경우 이 값도 업데이트해야 합니다.

pCallBack

사용자의 선택을 처리하는 콜백 함수에 대한 포인터입니다. 자세한 내용은 CounterPathCallBack을 참조하세요.

dwCallBackArg

콜백 함수에 전달되는 호출자 정의 값입니다.

CallBackStatus

콜백 함수에 입력할 때 이 멤버는 경로 버퍼의 상태 포함합니다. 종료 시 콜백 함수는 처리로 인한 상태 값을 설정합니다.

버퍼가 너무 작아서 현재 선택 영역을 로드할 수 없을 경우 대화 상자는 이 값을 PDH_MORE_DATA 설정합니다. 이 값이 ERROR_SUCCESS 경우 szReturnPathBuffer 멤버에 유효한 카운터 경로 또는 카운터 경로 목록이 포함됩니다.

콜백 함수가 새 버퍼를 다시 할당하는 경우 대화 상자가 선택한 경로로 버퍼를 로드하고 콜백 함수를 다시 호출하도록 이 멤버를 PDH_RETRY 설정해야 합니다.

다른 오류가 발생한 경우 콜백 함수는 적절한 PDH 오류 상태 값을 반환해야 합니다.

dwDefaultDetailLevel

bHideDetailBox가 FALSE인 경우 세부 정보 수준 목록에 표시할 기본 세부 정보 수준입니다. bHideDetailBox가 TRUE이면 대화 상자에서 이 값을 사용하여 표시된 성능 카운터 및 개체를 필터링합니다. 다음 값 중 하나를 지정할 수 있습니다.

세부 정보 수준	의미
PERF_DETAIL_NOVICE	초보 사용자는 카운터 데이터를 이해할 수 있습니다.
PERF_DETAIL_ADVANCED	카운터 데이터는 고급 사용자를 위해 제공됩니다.
PERF_DETAIL_EXPERT	카운터 데이터는 전문 사용자를 위해 제공됩니다.
PERF_DETAIL_WIZARD	카운터 데이터는 시스템 디자이너에 대해 제공됩니다.

szDialogBoxCaption

대화 상자의 캡션 표시줄에 표시할 선택적 캡션 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버가 NULL이면 캡션 찾아보기 성능 카운터가 됩니다.

설명

추가 단추를 클릭할 때마다 szReturnPathBuffer 버퍼에 선택한 카운터가 포함되고 pCallBack 콜백 함수가 호출됩니다. 콜백 함수는 버퍼의 각 카운터에 대해 PdhAddCounter 함수를 호출해야 합니다.

참고

pdh.h 헤더는 PDH_BROWSE_DLG_CONFIG_H 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

CounterPathCallBack

PdhAddCounter

PdhBindInputDataSource

PdhBrowseCountersH

다음을 통해 공유

PDH_BROWSE_DLG_CONFIG_HW 구조체(pdh.h)

구문

멤버

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스