CDaoWorkspace::Create

virtual void Create( LPCTSTR lpszName, LPCTSTR lpszUserName, LPCTSTR lpszPassword );
throw( CDaoException, CMemoryException );

Parameters

lpszName

A string with up to 14 characters that uniquely names the new workspace object. You must supply a name. For related information, see the topic "Name Property" in DAO Help.

lpszUserName

The user name of the workspace’s owner. For requirements, see the lpszDefaultUser parameter to the SetDefaultUser member function. For related information, see the topic "UserName Property" in DAO Help.

lpszPassword

The password for the new workspace object. A password can be up to 14 characters long and can contain any character except ASCII 0 (null). Passwords are case-sensitive. For related information, see the topic "Password Property" in DAO Help.

Remarks

Call this member function to create a new DAO workspace object and associate it with the MFC CDaoWorkspace object. The overall creation process is:

1. Construct a CDaoWorkspace object.
   
   
2. Call the object’s Create member function to create the underlying DAO workspace. You must specify a workspace name.
   
   
3. Optionally call Append if you want to add the workspace to the database engine’s Workspaces collection. You can work with the workspace without appending it.

After the Create call, the workspace object is in an open state, ready for use. You do not call Open after Create. You do not call Create if the workspace already exists in the Workspaces collection. Create initializes the database engine if it has not already been initialized for your application.

For more information about workspaces, see the article DAO Workspace in Visual C++ Programmer's Guide.

CDaoWorkspace Overview |  Class Members |  Hierarchy Chart

See Also   CDaoWorkspace::CDaoWorkspace, CDaoWorkspace::Close, CDaoWorkspace::Open