Contadores de exploración

Para mostrar un cuadro de diálogo que muestra los contadores y objetos de rendimiento definidos en el equipo, llame a la función PdhBrowseCounters . El cuadro de diálogo permite al usuario examinar y seleccionar contadores de rendimiento. Use la estructura PDH_BROWSE_DLG_CONFIG para especificar la configuración del cuadro de diálogo. Por ejemplo, puede configurar el cuadro de diálogo para devolver una selección o varias selecciones.

En la entrada, el miembro szReturnPathBuffer contiene el objeto de rendimiento predeterminado y el contador seleccionado en el cuadro de diálogo. En la salida, el búfer contiene el objeto de rendimiento y el contador que el usuario seleccionó. También puede usar el miembro pCallBack para especificar una función de devolución de llamada para procesar los nombres de contador devueltos por el cuadro de diálogo.

Tenga en cuenta que este cuadro de diálogo puede devolver PDH_DIALOG_CANCELLED si bSingleCounterPerDialog es FALSE y el usuario hace clic en el botón Cerrar, por lo que el control de errores tendría que tener en cuenta esto.

Para obtener un ejemplo que usa la función PdhBrowseCounters , vea Examinar contadores de rendimiento.

Para recuperar una lista de objetos de rendimiento en el equipo, también puede llamar a la función PdhEnumObjects . Para recuperar una lista de contadores e instancias de un objeto de rendimiento, llame a la función PdhEnumObjectItems . También puede usar estas funciones para identificar los objetos de rendimiento y los contadores contenidos en un archivo de registro. Las llamadas repetidas a PdhEnumObjectItems devolverán la misma lista de contadores e instancias hasta que llame a PdhEnumObjects para actualizar primero la lista de objetos de rendimiento. Para obtener un ejemplo que enumera objetos y contadores, vea Enumerar objetos de proceso.

Selección del origen de datos

Puede usar PdhSelectDataSource junto con PdhBrowseCounters para pedir al usuario que seleccione si el origen de datos está en tiempo real o desde un archivo de registro y, si es un archivo de registro, su nombre. Si no desea que se muestre el cuadro de diálogo del origen de datos, puede llamar a PdhSelectDataSource para mostrar solo el catálogo del explorador de archivos. Para ello, especifique PDH_FLAGS_FILE_BROWSER_ONLY como segundo parámetro de la llamada a PdhSelectDataSource.