Share via

CKato::BeginLevelV

  • Article

This method begins a new level in the logging hierarchy.

INT BeginLevelV(
  DWORD dwLevelID, 
  LPCTSTR szFormat, 
  va_list pArgs 
);

Parameters

  • dwLevelID
    Identifier value to be associated with all the output generated within the new level. This value is usually used to uniquely identify a test case or group of log output. This value may be used by log systems such as SQL to store the log output, or by a post-parser, which is needed to associate each line of log to a particular test or component.
  • 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 Values

This method 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 of organizing logging output into a hierarchical format. Levels should be closed when finished by calling the CKato::EndLevel method or CKato::EndLevelV method. All open levels will automatically be closed during the destruction of a CKato object.

This method fails if the current level is already at the maximum level defined by KATO_MAX_LEVEL.

Requirements

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

See Also

CKato::BeginLevel | CKato::EndLevel | CKato::EndLevelV | CKato::GetCurrentLevel

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.