Ns_TclDbGetHandle

Overview

Get a database handle

Syntax

    int Ns_TclDbGetHandle(
    	Tcl_Interp				*interp,
    	char				*handleId,
    	Ns_DbHandle				**handle
    );

Description

Ns_TclDbGetHandle gets the real handle from the interpreter that corresponds to the database handle id that gets passed in from Tcl. It is only useful in creating new Tcl commands that rely on the database.

The interp argument is a pointer to the interpreter the Tcl script is running in. The handleId argument is the Tcl database handle.

The handle argument is a pointer to a pointer to the real database handle. Pass in the address of the pointer, and Ns_TclDbGetHandle will set it to the real database handle.