Share via


KatoEndLevelV (Compact 2013)

3/26/2014

This function ends the current level in the logging hierarchy and appends the specified arguments to the log.

Syntax

INT KatoEndLevelV(
  HKATO hKato,
  LPCTSTR szFormat,
  va_list pArgs
);

Parameters

  • hKato
    Handle to a CKato object.
  • 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

Returns the new logging level if successful; otherwise, -1.

Remarks

Logging levels are usually used to group sets of tests or comments. They provide a mechanism to organize logging output into a hierarchical format. All open levels are automatically closed during the destruction of a CKato object.

The line of log that is generated by a call to this function is marked with a verbosity level equal to the lowest verbosity level logged within the entire level. With this marking, the lowest verbosity is propagated up to the parent level, to the parent of the parent level, and so on.

This function fails if the current level is already at level 0 (zero).

Requirements

Header

kato.h

See Also

Concepts

C Interface for Kato