wcDBSet( )

Syntax . . Returns . . Tips . . Related Topics . . A-Z Index . . Home

Sets the specified database server connection to the the active connection.

Example

returnCode = wcDBSet(cntrlHandle, "conn2");

Syntax

int wcDBSet(void *controlHandle, 
            char *conName)

controlHandle

The handle to the control structure.

conName

The name of the connection. Must be the conName specified in the wcDBOpen( ) call that opened the connection. Use the connection name returned by wcAppPageConnName() to set the active database connection to the AppPages repository. If you want to use wcDBSet() for the connection you set in your AppPages using , conName has to be the connection name you use in AppPages, plus the session ID appended at the end.

Returns

0	Success.
Error code	Failure or exception. For a list of possible error codes, see Error Messages.

Tips

Use wcDBSet( ) to switch back and forth between the AppPages repository database connection and user database connections.