KatoGetVerbosityCount (Windows Embedded CE 6.0)

1/6/2010

This function queries the number of times a given verbosity has been logged in a given level.

Syntax

INT KatoGetVerbosityCount(
  HKATO hKato,
  DWORD dwVerbosity,
  DWORD dwLevel
);

Parameters

• hKato
  Handle to a CKato object.

• dwVerbosity
  Verbosity level that you want to query. This value can range from zero to KATO_MAX_VERBOSITY.

• dwLevel
  Level in which to perform the query. You may query any level from the root level of zero down to the logger's current level. A value of -1 will perform the query at the logger's current level.

Return Value

Number of times the given verbosity has been logged in the given level. If dwLevel is greater than the current logging level, the return value is zero. If an error occurs, the return value is -1.

Remarks

This function is usually called by applications that keep statistics about the number of times a particular verbosity is logged. Usually particular verbosity values are associated with concepts such as pass and fail. If you structure your log in this manner, you can use this function to query the number of passes and failures that have occurred within a given level.

Requirements

See Also

Concepts

C Interface for Kato