PDH_BROWSE_DLG_CONFIG_W 구조체(pdh.h)
PDH_BROWSE_DLG_CONFIG 구조는 PdhBrowseCounters 함수에서 성능 카운터 찾아보기 대화 상자를 구성하는 데 사용됩니다.
구문
typedef struct _BrowseDlgConfig_W {
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;
LPWSTR szDataSource;
LPWSTR szReturnPathBuffer;
DWORD cchReturnPathLength;
CounterPathCallBack pCallBack;
DWORD_PTR dwCallBackArg;
PDH_STATUS CallBackStatus;
DWORD dwDefaultDetailLevel;
LPWSTR szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_W, *PPDH_BROWSE_DLG_CONFIG_W;
멤버
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인 경우 소유자는 바탕 화면입니다.
szDataSource
카운터 목록이 검색되는 로그 파일의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. NULL이면 카운터 목록이 로컬 컴퓨터(또는 지정된 경우 원격 컴퓨터)에서 검색됩니다.
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이면 대화 상자에서 이 값을 사용하여 표시된 성능 카운터 및 개체를 필터링합니다. 다음 값 중 하나를 지정할 수 있습니다.
szDialogBoxCaption
대화 상자의 캡션 표시줄에 표시할 선택적 캡션 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버가 NULL이면 캡션 성능 카운터 찾아보기입니다.
설명
추가 단추를 클릭할 때마다 szReturnPathBuffer 버퍼에 선택한 카운터가 포함되고 pCallBack 콜백 함수가 호출됩니다. 콜백 함수는 버퍼의 각 카운터에 대해 PdhAddCounter 함수를 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | pdh.h |