PDH_BROWSE_DLG_CONFIG_HA 구조체(pdh.h)

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

통사론

typedef struct _BrowseDlgConfig_HA {
  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;
  LPSTR               szReturnPathBuffer;
  DWORD               cchReturnPathLength;
  CounterPathCallBack pCallBack;
  DWORD_PTR           dwCallBackArg;
  PDH_STATUS          CallBackStatus;
  DWORD               dwDefaultDetailLevel;
  LPSTR               szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_HA, *PPDH_BROWSE_DLG_CONFIG_HA;

회원

bIncludeInstanceIndex

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

bSingleCounterPerAdd

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

bSingleCounterPerDialog

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

bLocalCountersOnly

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

bWildCardInstances

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

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

bHideDetailBox

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

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

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

bInitializePath

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

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

bDisableMachineSelection

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

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

bIncludeCostlyObjects

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

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

bShowObjectBrowser

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

bReserved

hWndOwner

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

hDataSource

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

szReturnPathBuffer

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

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

cchReturnPathLength

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

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

요구 사항

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

참고 항목

CounterPathCallBack

PdhAddCounter

PdhBindInputDataSource

PdhBrowseCountersH