Check Boxes

Check boxes are used to specify values for input arguments that accept environment, connection, or statement handles; input arguments that accept window handles; and output arguments that accept pointers to handles or pointers to output buffers. For example, check boxes are used to specify values for the ConnectionHandle, WindowHandle, OutConnectionString, and StringLength2Ptr arguments in SQLDriverConnect.

After each check box is the name of the argument and its value:

• For input arguments that accept handles, the value is either the handle value or a null handle (for example, SQL_NULL_HDBC or SQL_NULL_HANDLE). ODBC Test retrieves this value from the current environment handle, the connection handle of the current connection window, or the statement handle of the current statement in the current connection window.
  
  
• For input arguments that accept window handles and output arguments that accept pointers to handles or pointers to output buffers, the value is either VALID or NULL (for example, SQL_NULL_HANDLE).

A handle value of VALID indicates that ODBC Test will pass a valid, non-null pointer or handle; NULL indicates that ODBC Test will pass a null pointer or handle. To switch between the two, check or clear the check box.