PDH_BROWSE_DLG_CONFIG_HW-Struktur (pdh.h)

Die PDH_BROWSE_DLG_CONFIG_H-Struktur wird von der PdhBrowseCountersH-Funktion verwendet, um das Dialogfeld Leistungsindikatoren durchsuchen zu konfigurieren.

Syntax

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;

Member

bIncludeInstanceIndex

Wenn dieses Flag TRUE ist, enthält das Dialogfeld eine Indexnummer für doppelte instance Namen. Wenn z. B. zwei cmd-Instanzen vorhanden sind, enthält die liste instance cmd und cmd#1. Wenn dieses Flag FALSE ist, enthalten doppelte instance Namen keine Indexnummer.

bSingleCounterPerAdd

Wenn dieses Flag TRUE ist, gibt das Dialogfeld nur einen Zähler zurück. Wenn dieses Flag FALSE ist, kann das Dialogfeld mehrere Auswahlen zurückgeben, und Die Auswahl von Wildcards ist zulässig. Ausgewählte Leistungsindikatoren werden als MULTI_SZ Zeichenfolge zurückgegeben.

bSingleCounterPerDialog

Wenn dieses Flag TRUE ist, verwendet das Dialogfeld die Schaltflächen OK und Abbrechen. Das Dialogfeld wird zurückgegeben, wenn der Benutzer auf eine der Schaltflächen klickt. Wenn dieses Flag FALSE ist, verwendet das Dialogfeld die Schaltfläche Hinzufügen und Schließen. Das Dialogfeld wird geschlossen, wenn der Benutzer auf die Schaltfläche Schließen klickt. Auf die Schaltfläche Hinzufügen kann mehrmals geklickt werden. Die Schaltfläche Hinzufügen überschreibt die zuvor ausgewählten Elemente mit den aktuell ausgewählten Elementen.

bLocalCountersOnly

Wenn dieses Flag TRUE ist, kann der Benutzer im Dialogfeld Leistungsindikatoren nur auf dem lokalen Computer auswählen (der Pfad enthält keinen Computernamen). Wenn dieses Flag FALSE ist, kann der Benutzer einen Computer angeben, auf dem Leistungsindikatoren ausgewählt werden sollen. Der Computername präfixiert den Zählerpfad, es sei denn, der Benutzer wählt Lokale Computerzähler verwenden aus.

bWildCardInstances

Wenn dieses Flag TRUE ist und der Benutzer Alle Instanzen auswählt, enthält der Indikatorpfad das Platzhalterzeichen für das feld instance.

Wenn dieses Flag FALSE ist und der Benutzer Alle Instanzen auswählt, werden alle Instanzen, die derzeit für dieses Objekt gefunden werden, in einer MULTI_SZ Zeichenfolge zurückgegeben.

bHideDetailBox

Wenn dieses Flag TRUE ist, wird die Detailebene aus dem Dialogfeld entfernt, sodass der Benutzer die Detailebene der im Dialogfeld angezeigten Leistungsindikatoren nicht ändern kann. Die Detailebene wird auf den Wert des dwDefaultDetailLevel-Elements festgelegt.

Wenn dieses Flag FALSE ist, wird die Detailebene im Dialogfeld angezeigt, sodass der Benutzer die Detailebene der angezeigten Leistungsindikatoren ändern kann.

Beachten Sie, dass die angezeigten Leistungsindikatoren diejenigen sind, deren Detailebene kleiner oder gleich der aktuellen Auswahl der Detailebene ist. Wenn Sie eine Detailebene des Assistenten auswählen, werden alle Indikatoren und Objekte angezeigt.

bInitializePath

Wenn dieses Flag TRUE ist, hebt das Dialogfeld den in szReturnPathBuffer angegebenen Zähler und Objekt hervor, wenn das Dialogfeld zum ersten Mal angezeigt wird, anstatt den vom Computer angegebenen Standardzähler und das Vom Computer angegebene Objekt zu verwenden.

Wenn dieses Flag FALSE ist, werden der anfängliche Indikator und das Objekt mithilfe des Standardindikators und der vom Computer zurückgegebenen Objektinformationen ausgewählt.

bDisableMachineSelection

Wenn dieses Flag TRUE ist, kann der Benutzer keinen Computer unter Indikatoren vom Computer auswählen auswählen.

Wenn dieses Flag FALSE ist, kann der Benutzer unter Indikatoren vom Computer auswählen einen Computer auswählen. Dies ist der Standardwert. Die Liste enthält nur den lokalen Computer, es sei denn, Sie rufen pdhConnectMachine auf, um zuerst eine Verbindung mit anderen Computern herzustellen.

bIncludeCostlyObjects

Wenn dieses Flag TRUE ist, enthält die Indikatorenliste auch kostspielige Daten, d. h. Daten, für die eine relativ große Menge an Prozessorzeit oder Arbeitsspeicheraufwand erforderlich ist.

Wenn dieses Flag FALSE ist, enthält die Liste keine kostspieligen Leistungsindikatoren. Dies ist der Standardwert.

bShowObjectBrowser

Wenn dieses Flag TRUE ist, werden im Dialogfeld nur Leistungsobjekte aufgelistet. Wenn der Benutzer ein Objekt auswählt, gibt das Dialogfeld einen Zählerpfad zurück, der das Objekt und die Wildcardzeichen für den instance Namen und Zähler enthält, wenn das Objekt ein mehrfaches instance-Objekt ist. Wenn beispielsweise das Objekt "Process" ausgewählt ist, gibt das Dialogfeld die Zeichenfolge "\Process(*)*" zurück. Wenn es sich bei dem Objekt um ein einzelnes instance-Objekt handelt, enthält der Pfad nur für den Zähler ein Wildcardzeichen. Beispiel: "\System*". Anschließend können Sie den Pfad an PdhExpandWildCardPath übergeben, um eine Liste der tatsächlichen Pfade für das Objekt abzurufen.

bReserved

hWndOwner

Handle des Fensters, das besitzer des Dialogfelds ist. Bei NULL ist der Besitzer der Desktop.

hDataSource

Handle für eine Datenquelle, die von der PdhBindInputDataSource-Funktion zurückgegeben wird.

szReturnPathBuffer

Zeiger auf eine MULTI_SZ, die die ausgewählten Indikatorpfade enthält.

Wenn bInitializePathTRUE ist, können Sie diesen Member verwenden, um einen Indikatorpfad anzugeben, dessen Komponenten verwendet werden, um Einträge in Computer-, Objekt-, Leistungsindikator- und instance listen hervorzuheben, wenn das Dialogfeld zum ersten Mal angezeigt wird.

cchReturnPathLength

Größe des szReturnPathBuffer-Puffers in TCHARs. Wenn die Rückruffunktion einen neuen Puffer neu zuordnet, muss sie auch diesen Wert aktualisieren.

pCallBack

Zeiger auf die Rückruffunktion, die die Auswahl des Benutzers verarbeitet. Weitere Informationen finden Sie unter CounterPathCallBack.

dwCallBackArg

Vom Aufrufer definierter Wert, der an die Rückruffunktion übergeben wird.

CallBackStatus

Beim Einstieg in die Rückruffunktion enthält dieser Member die status des Pfadpuffers. Beim Beenden legt die Rückruffunktion den status Wert fest, der sich aus der Verarbeitung ergibt.

Wenn der Puffer zu klein ist, um die aktuelle Auswahl zu laden, legt das Dialogfeld diesen Wert auf PDH_MORE_DATA fest. Wenn dieser Wert ERROR_SUCCESS ist, enthält das szReturnPathBuffer-Element einen gültigen Indikatorpfad oder eine gültige Liste des Indikatorpfads.

Wenn die Rückruffunktion einen neuen Puffer neu zuordnet, sollte sie diesen Member auf PDH_RETRY festlegen, damit der Dialog versucht, den Puffer mit den ausgewählten Pfaden zu laden und die Rückruffunktion erneut aufzurufen.

Wenn ein anderer Fehler aufgetreten ist, sollte die Rückruffunktion den entsprechenden PDH-Fehler status Wert zurückgeben.

dwDefaultDetailLevel

Standarddetailebene, die in der Liste Detailebene angezeigt wird, wenn bHideDetailBoxauf FALSE festgelegt ist. Wenn bHideDetailBoxauf TRUE festgelegt ist, verwendet das Dialogfeld diesen Wert, um die angezeigten Leistungsindikatoren und -objekte zu filtern. Sie können einen der folgenden Werte angeben:

Detailebene	Bedeutung
PERF_DETAIL_NOVICE	Ein neuer Benutzer kann die Zählerdaten verstehen.
PERF_DETAIL_ADVANCED	Die Zählerdaten werden für fortgeschrittene Benutzer bereitgestellt.
PERF_DETAIL_EXPERT	Die Zählerdaten werden für erfahrene Benutzer bereitgestellt.
PERF_DETAIL_WIZARD	Die Zählerdaten werden für Systemdesigner bereitgestellt.

szDialogBoxCaption

Zeiger auf eine NULL-endende Zeichenfolge, die die optionale Untertitel angibt, die in der Untertitel leiste des Dialogfelds angezeigt werden soll. Wenn dieser Member NULL ist, lautet die Untertitel Leistungsindikatoren durchsuchen.

Hinweise

Jedes Mal, wenn auf die Schaltfläche Hinzufügen geklickt wird, enthält der puffer szReturnPathBuffer den ausgewählten Indikator, und die pCallBack-Rückruffunktion wird aufgerufen. Die Rückruffunktion sollte die PdhAddCounter-Funktion für jeden Zähler im Puffer aufrufen.

Hinweis

Der pdh.h-Header definiert PDH_BROWSE_DLG_CONFIG_H als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	pdh.h

Weitere Informationen

CounterPathCallBack

PdhAddCounter

PdhBindInputDataSource

PdhBrowseCountersH