Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
3/26/2014
This function logs a string to the current logging level with the specified arguments and verbosity level and tallies the verbosity value for the given level.
Syntax
BOOL KatoLogV(
HKATO hKato,
DWORD dwVerbosity,
LPCTSTR szFormat,
va_list pArgs
);
Parameters
- hKato
Handle to a CKato object.
- dwVerbosity
Verbosity level of this log message. This value can be between 0 (zero) and KATO_MAX_VERBOSITY.
- szFormat
Address of ANSI or UNICODE format-control string.
- pArgs
Pointer to a list of arguments. The number and type of argument parameters depend on the corresponding format-control specifications in the szFormat parameter.
Return Value
Nonzero if successful; otherwise, 0 (zero).
Remarks
Within each level of the log, a tally is kept for each verbosity level. Each time this function is called, the counter for the specified verbosity is incremented. You can use the KatoGetVerbosityCount function to query a level for its verbosity tallies. Typically, particular verbosity values are associated with concepts such as pass and fail. If you structure your log in this manner, you can use the KatoGetVerbosityCount function to query the number of passes and failures that have occurred within a given level.
Each logging system on the server side has a verbosity filter, which filters out all logs with verbosity values greater than the current filter value for that system. For this reason, you should structure the logs in an application so that the most critical logs get the lowest verbosity level. Typically, a severe failing log gets a verbosity level of 0 (zero).
Requirements
Header |
kato.h |