JET_DBINFOUPGRADE Structure

Applies to: Windows | Windows Server

JET_DBINFOUPGRADE Structure

The JET_DBINFOUPGRADE structure holds information about the upgrade status of the database. This value is retrieved only if JET_DBINFOUPGRADE was passed to JetGetDatabaseInfo or JetGetDatabaseFileInfo. This structure is not required for current operating system versions of the database engine.

    typedef struct {
      unsigned long cbStruct;
      unsigned long cbFilesizeLow;
      unsigned long cbFilesizeHigh;
      unsigned long cbFreeSpaceRequiredLow;
      unsigned long  cbFreeSpaceRequiredHigh;
      unsigned long csecToUpgrade;
      union {
        unsigned long ulFlags;
        struct {
          unsigned long fUpgradable  :1;
          unsigned long fAlreadyUpgraded  :1;
        };
      };
    } JET_DBINFOUPGRADE;

Members

cbStruct

Set to the size of the JET_DBINFOUPGRADE structure, in bytes.

cbFilesizeLow

The low DWORD that reflects the current file size for the database.

cbFilesizeHigh

The high DWORD that reflects the current file size for the database.

cbFreeSpaceRequiredLow

The low DWORD of estimated free disk space required for an in-place upgrade.

cbFreeSpaceRequiredHigh

The high DWORD of estimated free disk space required for an in-place upgrade.

csecToUpgrade

The estimated time required to upgrade, in seconds.

ulFlags

A bit field made of zero or more of the following flags: fUpgradable, fAlreadyUpgraded.

fUpgradable

The database is upgradeable.

fAlreadyUpgraded

The database is upgraded to the current database format.

Remarks

A JET_DBINFOUPGRADE structure is populated by a call to JetGetDatabaseInfo or JetGetDatabaseFileInfo. If the function does not succeed, the contents of the structure are undefined.

Requirements

See Also

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetGetIndexInfo
JetGetObjectInfo
JetGetTableIndexInfo
JetGetTableInfo