CKato::LogV (Windows Embedded CE 6.0)

1/6/2010

This method logs a string to the current logging level with a specified verbosity level. The verbosity value will be tallied for the given level.

Syntax

BOOL LogV(
  DWORD dwVerbosity,
  LPCTSTR szFormat,
  va_list pArgs
);

Parameters

• dwVerbosity
  Verbosity level of this log message. This value can be between 0 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, zero.

Remarks

Within each level of log, a tally is kept for each verbosity. Each time the CKato::Log method or CKato::LogV method is called, the counter for the specified verbosity is incremented. The CKato::GetVerbosityCount method can be used to query a level for its verbosity tallies. Usually particular verbosity values are associated with concepts such as pass and fail. If you structure your log in this manner, you can use the CKato::GetVerbosityCount method 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 that will filter out all logs with verbosity values greater than the current filter value for that system. For this reason, applications should structure their logging so that the most critical logs get the lowest verbosity level. Typically a severe failing log would get a verbosity level of 0.

Requirements

See Also

Concepts

CKato (C++)