Durchsuchen von Leistungsindikatoren

Um ein Dialogfeld anzuzeigen, in dem die auf dem Computer definierten Leistungsobjekte und Leistungsindikatoren aufgeführt sind, rufen Sie die PdhBrowseCounters-Funktion auf. Im Dialogfeld kann der Benutzer Leistungsindikatoren durchsuchen und auswählen. Sie verwenden die PDH _ BROWSE _ DLG _ CONFIG-Struktur, um die Konfiguration des Dialogfelds anzugeben. Beispielsweise können Sie das Dialogfeld so konfigurieren, dass eine Auswahl oder mehrfache Auswahl zurück angezeigt wird.

Bei der Eingabe enthält das szReturnPathBuffer-Element das Standardleistungsobjekt und den Leistungsindikator, die im Dialogfeld ausgewählt sind. Bei der Ausgabe enthält der Puffer das Leistungsobjekt und den Leistungsindikator, die der Benutzer ausgewählt hat. Sie können auch den pCallBack-Member verwenden, um eine Rückruffunktion anzugeben, um die vom Dialogfeld zurückgegebenen Indikatornamen zu verarbeiten.

Beachten Sie, dass dieses Dialogfeld PDH DIALOG CANCELLED zurückgeben kann, wenn _ _ bSingleCounterPerDialog FALSE ist und der Benutzer auf die Schaltfläche Schließen klickt, sodass die Fehlerbehandlung dies berücksichtigen muss.

Ein Beispiel, in dem die PdhBrowseCounters-Funktion verwendet wird, finden Sie unter Durchsuchen von Leistungsindikatoren.

Um eine Liste von Leistungsobjekten auf dem Computer abzurufen, können Sie auch die PdhEnumObjects-Funktion aufrufen. Um eine Liste von Leistungsindikatoren und Instanzen für ein Leistungsobjekt abzurufen, rufen Sie die PdhEnumObjectItems-Funktion auf. Sie können diese Funktionen auch verwenden, um die Leistungsobjekte und Leistungsindikatoren zu identifizieren, die in einer Protokolldatei enthalten sind. Wiederholte Aufrufe von PdhEnumObjectItems geben dieselbe Liste von Leistungsindikatoren und Instanzen zurück, bis Sie PdhEnumObjects aufrufen, um zuerst die Liste der Leistungsobjekte zu aktualisieren. Ein Beispiel, das Objekte und Leistungsindikatoren aufzählt, finden Sie unter Aufzählen von Prozessobjekten.

Auswählen der Datenquelle

Sie können PdhSelectDataSource in Verbindung mit PdhBrowseCounters verwenden, um den Benutzer aufzufordern, auszuwählen, ob sich die Datenquelle in Echtzeit oder aus einer Protokolldatei befindet, und, wenn es sich um eine Protokolldatei handelt, ihren Namen auszuwählen. Wenn das Datenquellendialogfeld nicht angezeigt werden soll, können Sie PdhSelectDataSource aufrufen, um nur den Dateibrowserkatalog anzuzeigen. Geben Sie hierzu PDH FLAGS FILE BROWSER ONLY als zweiten Parameter des Aufrufs von _ _ _ _ PdhSelectDataSource an.