Browsebalies

Als u een dialoogvenster wilt weergeven met de prestatieobjecten en prestatiemeteritems die op de computer zijn gedefinieerd, roept u de PdhBrowseCounters-functie aan. In het dialoogvenster kan de gebruiker door prestatiemeteritems bladeren en selecteren. U gebruikt de PDH_BROWSE_DLG_CONFIG structuur om de configuratie van het dialoogvenster op te geven. U kunt bijvoorbeeld het dialoogvenster configureren om één selectie of meerdere selecties te retourneren.

Bij invoer bevat de szReturnPathBuffer lid het standaardprestatieobject en de teller die is geselecteerd in het dialoogvenster. Bij uitvoer bevat de buffer het prestatieobject en de prestatiemeteritem die de gebruiker heeft geselecteerd. U kunt ook het pCallBack- element gebruiken om een callback-functie te specificeren die de tellernamen verwerkt die door het dialoogvenster zijn geretourneerd.

Houd er rekening mee dat dit dialoogvenster PDH_DIALOG_CANCELLED kan teruggeven als bSingleCounterPerDialog de waarde FALSE heeft en de gebruiker op de knop Sluiten klikt, zodat uw foutafhandeling daarmee rekening moet houden.

Zie Browse Performance Countersvoor een voorbeeld dat gebruikmaakt van de functie PdhBrowseCounters.

Als u een lijst met prestatieobjecten op de computer wilt ophalen, kunt u ook de functie PdhEnumObjects aanroepen. Als u een lijst met tellers en exemplaren voor een prestatieobject wilt ophalen, roept u de functie PdhEnumObjectItems aan. U kunt deze functies ook gebruiken om de prestatieobjecten en prestatiemeteritems in een logboekbestand te identificeren. Herhaalde aanroepen naar PdhEnumObjectItems retourneren dezelfde lijst met tellers en exemplaren totdat u PdhEnumObjects aanroept om eerst de lijst met prestatieobjecten te vernieuwen. Zie Procesobjecten opsommenvoor een voorbeeld van het opsommen van objecten en tellers.

De gegevensbron selecteren

U kunt PdhSelectDataSource- gebruiken in combinatie met PdhBrowseCounters om de gebruiker te vragen of de gegevensbron in realtime of vanuit een logboekbestand is en, als het een logboekbestand is, de naam ervan. Als u niet wilt dat het dialoogvenster voor de gegevensbron wordt weergegeven, kunt u PdhSelectDataSource- aanroepen om alleen de catalogus van de bestandsbrowser weer te geven. Geef hiervoor PDH_FLAGS_FILE_BROWSER_ONLY op als de tweede parameter van de aanroep naar PdhSelectDataSource.