Share via

KatoEndLevel

  • Article

This function ends the current level in the logging hierarchy.

INT KatoEndLevel(
  HKATO hKato, 
  LPCTSTR szFormat
);

Parameters

  • hKato
    Handle to a CKato object.
  • szFormat
    Address of ANSI or UNICODE format-control string.

Return Values

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

Remarks

One or more optional arguments can also be used in this function. The number and type of argument parameters depends on the corresponding format-control specifications in the szFormat parameter.

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

The line of log 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 will fail if the current level is already at level zero.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Kato.h.
Link Library: Kato.lib.

See Also

C Interface for Kato | KatoBeginLevel | KatoGetCurrentLevel

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.