Durchsuchen von Leistungsindikatoren

Um ein Dialogfeld anzuzeigen, das die auf dem Computer definierten Leistungsobjekte und Leistungsindikatoren auflistet, rufen Sie die PdhBrowseCounters-Funktion auf . Im Dialogfeld können 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 mehrere Auswahlen zurückgegeben werden.

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

Beachten Sie, dass dieses Dialogfeld PDH_DIALOG_CANCELLED zurückgeben kann, wenn bSingleCounterPerDialogFALSE ist und der Benutzer auf die Schaltfläche Schließen klickt, sodass dies bei der Fehlerbehandlung berücksichtigt werden muss.

Ein Beispiel, das die Funktion PdhBrowseCounters verwendet, finden Sie unter Browserleistungsindikatoren.

Um eine Liste der Leistungsobjekte 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 in einer Protokolldatei zu identifizieren. 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. Wenn das Dialogfeld "Datenquelle" 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.