Función PdhVbGetOneCounterPath

La función PdhVbGetOneCounterPath muestra un cuadro de diálogo que permite al usuario examinar los contadores de rendimiento disponibles y seleccionar un contador. El contador seleccionado se devuelve en la variable PathString . La variable PathString debe dimensionarse e inicializarse antes de llamar a esta función y el tamaño dimensionado debe indicarse mediante la variable PathLength .

Importante

La función que describe este tema puede modificarse o no estar disponible en el futuro. En su lugar, Microsoft recomienda usar las funciones descritas en Funciones de contadores de rendimiento.

Función PdhVbGetOneCounterPath( _ ByVal PathString as String, _ ByVal PathLength as Long, _ ByVal DetailLevel As Long, _ ByVal CaptionString as String _ ) As Long

Parámetros

PathString

Variable de cadena inicializada usada para recibir la ruta de acceso del contador seleccionada por el usuario.

PathLength

Longitud de pathString inicializada.

DetailLevel

Tipos de contadores que se van a mostrar en el cuadro de diálogo. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
PERF_DETAIL_ADVANCED	Los contadores que es probable que el usuario avanzado comprenda, además de los contadores de usuario principiantes.
PERF_DETAIL_EXPERT	Es probable que los contadores que el usuario experto y el desarrollador de software comprendan, además de los contadores para los usuarios principiantes y avanzados.
PERF_DETAIL_NOVICE	Solo los contadores que es probable que comprenda el usuario novato.
PERF_DETAIL_WIZARD	Todos los contadores del sistema.

CaptionString

Variable de cadena que contiene el texto que se mostrará en la barra subtítulo del cuadro de diálogo.

Valor devuelto

La función devuelve el número de caracteres escritos en el búfer PathString .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Biblioteca	Pdh.lib
Archivo DLL	Pdh.dll

Consulte también

PdhVbCreateCounterPathList

PdhVbGetCounterPathElements

PdhVbGetCounterPathFromList