wxdbconnectinf

this class is used for holding the data necessary for connecting to the odbc datasource. that information includes: sql environment handle, datasource name, user id, password and default directory path (used with dbase). other optional fields held in this class are and file type, both for future functions planned to be added for creating/manipulating datasource definitions.

wxdbconnectinf::wxdbconnectinf
wxdbconnectinf::~wxdbconnectinf
wxdbconnectinf::allochenv
wxdbconnectinf::freehenv
wxdbconnectinf::initialize
wxdbconnectinf::getauthstr
wxdbconnectinf::getdefaultdir
wxdbconnectinf::getdescription
wxdbconnectinf::getdsn
wxdbconnectinf::getfiletype
wxdbconnectinf::gethenv
wxdbconnectinf::getpassword
wxdbconnectinf::getuid
wxdbconnectinf::getuserid
wxdbconnectinf::setauthstr
wxdbconnectinf::setdefaultdir
wxdbconnectinf::setdescription
wxdbconnectinf::setdsn
wxdbconnectinf::setfiletype
wxdbconnectinf::sethenv
wxdbconnectinf::setpassword
wxdbconnectinf::setuid
wxdbconnectinf::setuserid

wxdbconnectinf::wxdbconnectinf

wxdbconnectinf()

default constructor.

wxdbconnectinf(henv henv, const wxstring &dsn, const wxstring &userid="", const wxstring &password, const wxstring &defaultdir="", const wxstring &description="", const wxstring &filetype="")

constructor which allows initial settings of all the classes member variables.

see the special note below on the henv parameter for forcing this constructor to create a sql environment handle automatically, rather than needing to pass one in to the function.

parameters

henv

environment handle used for this connection. see wxdconnectinf::allochenv for how to create an sql environment handle. note: passing in a null for this parameter will inform the constructor that it should create its own sql environment handle. if null is passed for this parameter, the constructor will call wxdconnectinf::allochenv internally. a flag is set internally also to indicate that the henv was created by the constructor so that when the default class destructor is called, the destructor will call wxdconnectinf::freehenv to free the environment handle automatically.

name of the datasource to be used in creating wxdb instances for creating connection(s) to a datasource.

optional many datasources allow (or even require) use of a username to determine privileges that connecting user is allowed to have when accessing the datasource or the data tables. default is "".

optional password to be associated with the user id specified in 'userid'. default is "".

optional used for datasources which require the path to where the data file is stored to be specified. dbase is one example of the type of datasource which requires this information. default is "".

optional future use default is "".

optional future use default is "".

remarks

it is strongly recommended that programs use the longer form of the constructor and allow the constructor to create the sql environment handle automatically, and manage the destruction of the handle.

example

   wxdbconnectinf *dbconnectinf;

	dbconnectinf = new wxdbconnectinf(0,"my_dsn", "my_user", "my_password");

	....the rest of the program

	delete dbconnectinf;

wxdconnectinf::allochenv, wxdconnectinf::freehenv

wxdbconnectinf::~wxdbconnectinf

~wxdbconnectinf()

handles the default destruction of the instance of the class. if the long form of the wxdconnectinf was used, then this destructor also takes care of calling wxdconnectinf::freehenv to free the sql environment handle.

wxdbconnectinf::allochenv

bool allochenv()

allocates a sql environment handle that will be used to interface with an odbc datasource.

remarks

this function can be automatically called by the long from of the wxdbconnectinf constructor.

wxdbconnectinf::freehenv

void freehenv()

frees the sql environment handle being managed by the instance of this class.

remarks

if the sql environment handle was created using the long form of the wxdbconnectinf constructor, then the flag indicating that the henv should be destroyed when the classes destructor is called is reset to be false, so that any future handles created using the wxdbconnectinf::allochenv function must be manually released with a call to this function.

wxdbconnectinf::initialize

simply initializes all member variables to a cleared state. called by the constructor automatically.

wxdbconnectinf::getauthstr

const wxchar * getauthstr()

accessor function to return the password assigned for this class instance that will be used with the user id.

synonymous with wxdbconnectinf::getpassword

wxdbconnectinf::getdefaultdir

const wxchar * getdefaultdir()

accessor function to return the default directory in which the datasource's data table is stored. this directory is only used for file based datasources like dbase. ms-access does not require this to be set, as the path is set in the odbc administrator for ms-access.

wxdbconnectinf::getdescription

const wxchar * getdescription()

accessor function to return the description assigned for this class instance.

note: description is a future use item and is unused currently.

wxdbconnectinf::getdsn

const wxchar * getdsn()

accessor function to return the datasource name assigned for this class instance.

wxdbconnectinf::getfiletype

const wxchar * getfiletype()

accessor function to return the filetype of the odbc datasource assigned for this class instance.

note: filetype is a future use item and is unused currently.

wxdbconnectinf::gethenv

const henv gethenv()

accessor function to return the sql environment handle being managed by this class instance.

wxdbconnectinf::getpassword

const wxchar * getpassword()

accessor function to return the password assigned for this class instance that will be used with the user id.

synonymous with wxdbconnectinf::getauthstr

wxdbconnectinf::getuid

const wxchar * getuid()

accessor function to return the user id assigned for this class instance.

wxdbconnectinf::getuserid

const wxchar * getuserid()

accessor function to return the user id assigned for this class instance.

wxdbconnectinf::setauthstr

setauthstr(const wxstring &authstr)

accessor function to assign the password for this class instance that will be used with the user id.

synonymous with wxdbconnectinf::setpassword

wxdbconnectinf::setdefaultdir

setdefaultdir(const wxstring &defdir)

accessor function to assign the default directory in which the datasource's data table is stored. this directory is only used for file based datasources like dbase. ms-access does not require this to be set, as the path is set in the odbc administrator for ms-access.

wxdbconnectinf::setdescription

setdescription(const wxstring &desc)

accessor function to assign the description assigned for this class instance.

note: description is a future use item and is unused currently.

wxdbconnectinf::setdsn

setdsn(const wxstring &dsn)

accessor function to assign the datasource name for this class instance.

wxdbconnectinf::setfiletype

setfiletype(const wxstring &)

accessor function to return the filetype of the odbc datasource assigned for this class instance.

note: filetype is a future use item and is unused currently.

wxdbconnectinf::sethenv

void sethenv(const henv henv)

accessor function to set the sql environment handle for this class instance.

wxdbconnectinf::setpassword

setpassword(const wxstring &password)

accessor function to assign the password for this class instance that will be used with the user id.

synonymous with wxdbconnectinf::setauthstr

wxdbconnectinf::setuid

setuid(const wxstring &uid)

accessor function to set the user id for this class instance.

wxdbconnectinf::setuserid

setuserid(const wxstring &userid)

accessor function to assign the user id for this class instance.