CdbWorkspace::SetName, GetName Property

Sets or returns a user-defined name for a CdbWorkspace object. For an object not appended to a collection, this property is read/write.

Settings and Return Values

The setting or return value is a string that specifies a name. The name must start with a letter and can contain a maximum of 64 characters. It can include numbers and underscore characters but can't include punctuation or spaces.

Syntax

VOIDSetName(LPCTSTR pstr);

StringGetName(VOID);

Set Parameters

Type Example Description
LPCTSTR pstr A pointer to a string that contains the name of the CdbWorkspace object.

Remarks

Create a Workspace object using the Name and UserName properties to establish a named, password-protected session. The session creates a scope in which you can open multiple databases and conduct one instance of nested transactions. Use the Close method to terminate a session.