The DatabaseDesc object provides information about a particular database.
If you already know which database to log on to, you do not need to obtain a DatabaseDesc object to log on to the database. However, suppose that you want to have a logon window that presents to the user a list of the available databases. You can call the Session object's GetAccessibleDatabases method, which returns a list of DatabaseDesc objects.
When you have a DatabaseDesc object, you can:
You can also use a DatabaseDesc object inside a hook. In this case, you would call the Session object's GetSessionDatabase method to retrieve the DatabaseDesc object that has information about the current database.