Native C++ Texas API Documentation

Delevopers Native C++ Texas API Connect

Connect

Connect estabilsh a connecting between client and/or server.

unsigned int Connect(
	ServerType type,
	const char *userName,
	const char *password,
	const char *execPath,
	const char *dataPath,
	short language,
	pCallbackRoutine connectionHandler,
	void* objectID
);

unsigned int Connect(
   ServerType type,
   const char *userName,
   const char *password,
   const char *key,
   short language,
   pCallbackRoutine connectionHandler,
   void* objectID,
   const unsigned int* altAddress = NULL,
   int altAddress_l = 0,
   int maximumPacket = 16376
);

Parameters

type	The expected server class to connected to.
userName	User name used for the connection.
password	Reqired.
key	If the first four bytes is ".key" then buffer contains the texas key, otherwise the key is the key path directory
execPath	For Local connection.
dataPath	Database control file For local server connection.
language	Used for error messages from the server about the connection.
connectionHandler	Used by the server to return infomation about the connection.
objectID	Returned to the connectionHandler.
altAddress	Alternative texas server addresses.
altAddress_l	Length of altAddress buffer.
maximumPacket	Default packet size for the connection.

Return Values

If the method succeeds, the return value is zero else see error codes for more details.

Remarks

Example Use

CTexasAPI server();
if(server.Connect(CTexasAPI::TEXAS_DBE,"MyUserName","MyPassword","C:\\KeyPath",0,NULL,NULL) == NO_ERROR)
   server.Disconnect();
else MessageBox("Unable to connect to server");

Also See

Disconnect