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. |