Función PdhVbGetCounterPathElements

La función PdhVbGetCounterPathElements analiza una cadena de ruta de acceso de contador de rendimiento completa en sus elementos individuales. Cada una de las variables de cadena debe tener el mismo tamaño (BufferSize) y dimensionar e inicializarse antes de que se use en esta función.

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.

Function PdhVbGetCounterPathElements( _ ByVal PathString As String, _ ByVal MachineName As String, _ ByVal ObjectName As String, _ ByVal InstanceName As String, _ ByVal ParentInstance As String, _ ByVal CounterName As String, _ ByVal BufferSize As Long _ ) As Long

Parámetros

PathString

Cadena de ruta de acceso de contador que se va a dividir en sus elementos individuales.

MachineName

Cadena para recibir el nombre del equipo.

ObjectName

Cadena para recibir el nombre del objeto.

InstanceName

Cadena para recibir el nombre de instancia, si se usa.

ParentInstance

Cadena para recibir la instancia primaria, si se usa.

CounterName

Cadena para recibir el nombre del contador.

BufferSize

Tamaño máximo de cada variable de cadena que se usa como parámetro para esta llamada de función.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un entero Long igual a ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto	Descripción
PDH_INVALID_ARGUMENT	Uno o varios de los búferes de cadena no son el tamaño correcto.
PDH_MORE_DATA	Uno o varios de los elementos de ruta de acceso del contador son demasiado grandes para la longitud del búfer de retorno.
PDH_MEMORY_ALLOCATION_FAILURE	No se pudo asignar un búfer de memoria temporal.

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

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath