Función PdhVbAddCounter

La función PdhVbAddCounter crea una entrada de contador en el objeto de consulta especificado y devuelve un identificador a ese contador tras la finalización correcta.

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 PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath as String, _ ByVal CounterHandle As Long _ ) As Long

Parámetros

QueryHandle

Identificador de la consulta a la que se va a asignar este contador. La función PdhVbOpenQuery devuelve este valor.

CounterPath

Cadena de texto que especifica el nombre de la ruta de acceso del contador que se va a agregar a la consulta. El contenido de esta cadena debe ser una ruta de acceso de contador válida, como se obtiene del explorador de contadores u otro origen.

CounterHandle

Referencia única que identifica este contador en la consulta. Esta variable debe inicializarse en cero antes de llamar a la función. Contiene un valor válido al devolver solo si la función se completa correctamente.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un entero Long igual a ERROR_SUCCESS y un nuevo identificador en la variable CounterHandle .

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 argumentos no son válidos o incorrectos.
PDH_MEMORY_ALLOCATION_FAILURE	No se pudo asignar un búfer de memoria.
PDH_INVALID_HANDLE	El identificador de consulta no es válido.
PDH_CSTATUS_NO_COUNTER	No se encontró el contador especificado.
PDH_CSTATUS_NO_OBJECT	No se encontró el objeto especificado.
PDH_CSTATUS_NO_MACHINE	No se pudo crear una entrada de equipo.
PDH_CSTATUS_BAD_COUNTERNAME	Se pasó una cadena de ruta de acceso de nombre de contador vacía.
PDH_FUNCTION_NOT_FOUND	No se pudo determinar la función de cálculo de este contador.

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

PdhVbOpenQuery