ddlBegin() - create a TB API context

ddlBegin() - create a TB API context

Prototype:

   void ddlBegin(
      CONTROL *ctl);

Description:

ddlBegin() creates a TB API context and stores a handle to the context in ctl->ddlHandle. The remaining members of the CONTROL{} structure are initialized to zeroes.

For all other TB API functions, the first parameter is a pointer to a CONTROL{} structure with a valid context handle.

After all references to a context are complete, the context is destroyed by the ddlEnd() function.

ddlOpen() and ddlClose() are an exception to the above paradigm for creating and destroying a context. ddlOpen() actually consists of calls to ddlBegin() and ddlOpenR(); and ddlClose() consists of calls to ddlCloseR() and ddlEnd().

Functions that require a literal ddlBegin() and ddlEnd() are:
ddlCompileDBD();
ddlCompileAI();

Also see:
ddlEnd() - terminate a TB API context
ddlCloneConnection() - initialize a duplicate of a TB API context