Compartir a través de


Comprobar códigos de estado de datos de contador

El valor devuelto de las funciones PDH indica el éxito o error de la llamada de función, que es diferente del estado de los datos del contador. Compruebe siempre el miembro CStatus de un valor de contador devuelto en las estructuras PDH para asegurarse de que los datos devueltos son válidos antes de usarlos. Si el valor del miembro CStatus no indica que se ha realizado correctamente, no use los datos. A continuación se muestran los valores de estado posibles para los contadores:

Valor Significado
PDH_CSTATUS_NO_MACHINE PDH no pudo conectarse al equipo especificado en la ruta de acceso del contador. Si se devuelve este estado cuando se agrega el contador, el contador no se inicializa completamente. Cada vez que se actualiza la consulta, PDH reintenta la conexión. Cuando se establece la conexión, se reanuda la recopilación de datos normal.
PDH_CSTATUS_NO_OBJECT Se encontró el equipo especificado, pero se encontró el objeto de rendimiento especificado en el equipo. Si se devuelve este estado cuando se agrega el contador, el contador especificado no se incluye en la consulta. Si un contador activo devuelve este estado, los datos de ese contador no son válidos. Cada vez que se solicitan los datos, PDH intenta obtener estos datos de contador.
PDH_CSTATUS_NO_INSTANCE No se encontró la instancia especificada en el objeto . Si se devuelve este estado mientras se agrega el contador a la consulta, el contador se agrega correctamente a la consulta, pero no hay datos disponibles hasta que aparezca la instancia específica y se devuelva un estado correcto.
PDH_CSTATUS_NO_COUNTER No se encontró el contador especificado en el objeto especificado. Si se devuelve este estado cuando se agrega el contador, el contador no se agrega a la consulta. Si este estado se devuelve después de la recopilación de datos, los datos de ese contador no son válidos. Cada vez que se solicitan los datos, PDH intenta obtener estos datos de contador.
PDH_CSTATUS_INVALID_DATA El contador se encontró correctamente, pero los datos devueltos no son válidos. Este error puede producirse si el valor del contador es menor que el valor anterior. (Dado que los valores de contador siempre se incrementan, el valor del contador pasa a cero cuando alcanza su valor máximo). Otra posible causa es un temporizador del sistema que no es correcto.
PDH_CSTATUS_VALID_DATA Los datos del contador se devolvieron correctamente, pero no se modificaron desde la última vez que se leyó el contador.
PDH_CSTATUS_NEW_DATA Los datos del contador se devolvieron correctamente y son diferentes de la última vez que se leyó el contador. PDH_CSTATUS_NEW_DATA se pueden devolver en un contador de frecuencia incluso si la tasa resultante es la misma que la última muestra. Esto se debe a que el valor de datos sin procesar que se usa en la determinación de este valor de estado ha cambiado, no la tasa calculada.
PDH_MORE_DATA El búfer proporcionado no era lo suficientemente grande como para almacenar todos los datos del contador. Asigne un búfer mayor y vuelva a ejecutar la función.
PDH_CSTATUS_ITEM_NOT_VALIDATED El contador se ha agregado a la consulta, pero no se ha validado ni se ha accedido a él. No hay información de estado adicional sobre este contador disponible.
PDH_CSTATUS_NO_COUNTERNAME No se especificó ningún nombre de contador en la consulta.
PDH_CSTATUS_NO_COUNTER No se encontró el nombre del contador especificado.
PDH_CSTATUS_NO_OBJECT No se encontró el objeto de rendimiento especificado.
PDH_CALC_NEGATIVE_DENOMINATOR Un contador tiene un valor de denominador negativo.
PDH_CALC_NEGATIVE_TIMEBASE Un contador tiene un valor de base de tiempo negativo.
PDH_CALC_NEGATIVE_VALUE Un contador tiene un valor negativo.
PDH_CSTATUS_NO_COUNTERNAME No se especificó ninguna ruta de acceso de contador.
PDH_CSTATUS_BAD_COUNTERNAME El formato de ruta de acceso del contador es incorrecto.