In | hConnection | Connection handle that identifies the server. Connection handles are obtained with the PvConnectServer() function. |
In | dbNameExisting | Name of the existing database |
In | dbNameNew | Name of the new database. Set this parameter to NULL if you want the database name to remain unchanged. |
In | dictPath | Dictionary path. |
In | dataPath | Data path. Set this value to NULL to use the default data path (that is, the same as the dictionary path) If you want to modify a database to include MicroKernel Engine data files located in multiple paths, specify this parameter as a semicolon (;) delimited list. For example: C:\data\path1;C:\data\path2 |
In | dbFlags | Database flags, which can be a combination of the P_DBFLAG_ constants. P_DBFLAG_RI (enforce integrity constraints, including referential integrity and triggers) P_DBFLAG_BOUND (stamps the database name on the dictionary files so only that database can use them) P_DBFLAG_DBSEC_AUTHENTICATION (use database security authentication, Mixed security policy. See Btrieve Security Policy.) P_DBFLAG_DBSEC_AUTHORIZATION (use database security authorization, Database security policy. See Btrieve Security Policy.) P_DBFLAG_LONGMETADATA (use V2 metadata. See Metadata Version.) |
P_OK | The operation was successful. |
P_E_INVALID_HANDLE | Invalid connection handle. |
P_E_NULL_PTR | Call with NULL pointer |
P_E_ACCESS_RIGHT | Insufficient access right for the operation |
P_E_NOT_EXIST | Named database does not exist on the server. |
P_E_FAIL | Failed for other reasons. |
This Flag Combination | Represents this Security Model |
No flags | Classic |
P_DBFLAG_DBSEC_AUTHENTICATION | Mixed |
P_DBFLAG_DBSEC_AUTHENTICATION P_DBFLAG_DBSEC_AUTHORIZATION | Database |