AutoTestName

Description

AutoTestName returns the name of the auto test and the number of test cases it contains.

C Prototype

BOOL EXTFUN AutoTestName(
LPTSTR szName, /* Output:  Auto test name */
UINT FAR * piTestCases), /* Output:  Number of test cases */

Arguments

szName

The name of the auto test, such as "SQLAllocStmt Tests," is returned in the szName argument. This name must not exceed AUTO_MAX_TEST_NAME characters.

piTestCases

The number of test cases in the auto test is returned in the piTestCases argument.

Return Value

TRUE if the auto-test name is copied (with or without truncation) to szName and the number of test cases in the auto test is copied to piTestCases. Otherwise, FALSE.

Comments

ODBC Test calls this function to determine the name of the auto test and the number of test cases it contains.

Code Example

The following code example shows a simple AutoTestName function:

BOOL EXTFUN AutoTestName(LPSTR szName, UINT * iTestCases);
{
   /* The returned name is shorter than AUTO_MAX_TEST_NAME. */
   lstrcpy(szName, "SQLAllocStmt Tests");
   *iTestCases = 10;
   return TRUE;
}