JET_INSTANCE_INFO Structure

Windows

The JET_INSTANCE_INFO structure receives information about running database instances when used with the JetGetInstanceInfo and JetOSSnapshotFreeze functions.

typedef struct _JET_INSTANCE_INFO {
  JET_INSTANCE hInstanceId;
  tchar* szInstanceName;
  JET_API_PTR cDatabases;
  tchar** szDatabaseFileName;
  tchar** szDatabaseDisplayName;
  tchar** szDatabaseSLVFileName;
} JET_INSTANCE_INFO;

Members

hInstanceId

The JET_INSTANCE of the given instance.

szInstanceName

The name of the database instance. This value can be NULL if the instance does not have a name.

cDatabases

The number of databases that are attached to the database instance. cDatabases also holds the size of the arrays of strings that are returned in szDatabaseFileName, szDatabaseDisplayName, and szDatabaseSLVFileName.

szDatabaseFileName

An array of strings, each holding the file name of a database that is attached to the database instance. The array has cDatabases elements.

szDatabaseDisplayName

An array of strings, each holding the display name of a database. Currently the string can be NULL. The array has cDatabases elements.

szDatabaseSLVFileName

An array of strings, each holding the file name of the SLV file that is attached to the database instance. The array has cDatabases elements. SLV files are not supported, so this field should be ignored.

Remarks

Each database instance can have several databases attached to it.

For a given JET_INSTANCE_INFO structure, the array of strings that is returned for the databases are in the same order. For example, "szDatabaseDisplayName[ i ]" and "szDatabaseFileName[ i ]" both refer to the same database.

Requirements

Client

Requires Windows Vista, Windows XP, or Windows 2000 Professional.

Server

Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.

Header

Declared in Esent.h.

Unicode

Implemented as JET_INSTANCE_INFO_W (Unicode) and JET_INSTANCE_INFO _A (ANSI).

See Also

Community Additions

ADD
Show:
© 2014 Microsoft