FUNCTION_TABLE_ENTRY

This structure is used to hold information about a Tux test DLL module test case or test group.

typedef struct _FUNCTION_TABLE_ENTRY {
  LPCTSTR lpDescription;
  UINT uDepth;
  DWORD dwUserData;
  DWORD dwUniqueID;
  TESTPROC lpTestProc;
} FUNCTION_TABLE_ENTRY, *LPFUNCTION_TABLE_ENTRY;

Members

  • lpDescription
    This member is used to describe the test case or test group that the current structure represents. This is the string that is displayed to identify the particular test case or test group within Tux. lpDescription can point to an ANSI or UNICODE string, depending on how your test module builds.
  • uDepth
    This member is used to provide test modules with a mechanism to build hierarchies of test groups and test cases. A value of 0 implies that this is a root level test or group. A value of n would imply that this group or test belongs to the most recent prior entry in the table that has a depth of n-1.
  • dwUserData
    This member contains a user-defined value that is not used by Tux. This value is passed into the TestProc function pointed to by lpTestProc at execution time. It is often used to pass a structure pointer or flag to a single test function that can perform more than one operation. A single test function may appear in the function table more than once, but perform a different task depending on the value in dwUserData.
  • dwUniqueID
    This member contains a user-defined value that is used to uniquely identify the given test case. Tux uses this value to identify a particular test case when saving and loading suites. When defining dwUniqueID, no two test cases can have the same value. This value is obtainable at run time from within the TestProc procedure pointed to by lpTestProc.
  • lpTestProc
    This member contains a function pointer that is used to point to the actual test function for a given entry. If the entry is being used as a test group, this member must be NULL.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Tux.h.

See Also

Tux Architecture

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.