Funzione JetGetDatabaseFileInfo
Si applica a: Windows | Windows Server
Funzione JetGetDatabaseFileInfo
La funzione JetGetDatabaseFileInfo recupera vari tipi di informazioni sul database. Questa API può essere chiamata mentre un database è collegato o online (con JetGetDatabaseInfo) o mentre il database o il motore di database è offline (con JetGetDatabaseFileInfo).
JET_ERR JET_API JetGetDatabaseFileInfo(
__in const tchar* szDatabaseName,
__out void* pvResult,
__in unsigned long cbMax,
__in unsigned long InfoLevel
);
Parametri
szDatabaseName
Percorso del database da cui recuperare le informazioni.
pvResult
Puntatore a un buffer che riceverà le informazioni specificate. Le dimensioni del buffer, in byte, vengono passate in cbMax.
Se questa funzione ha esito negativo, il contenuto di pvResult non è definito.
Le informazioni archiviate in pvResult dipendono da InfoLevel.
cbMax
Dimensione, in byte, del buffer passato in pvResult.
InfoLevel
InfoLevel specifica il tipo di informazioni da recuperare sul database specificato. Influisce sulla modalità di interpretazione di pvResult . Alcuni oggetti InfoLevel sono disponibili solo nella versione offline (JetGetDatabaseFileInfo) o online (JetGetDatabaseInfo) dell'API.
Se il buffer pvResult specificato è troppo piccolo, verranno restituiti JET_errInvalidBufferSize o JET_errBufferTooSmall, a seconda dell'InfoLevel.
Valore |
Significato |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
JET_DbInfoFilesize |
pvResult verrà interpretato come QWORD (8 byte). Restituisce le dimensioni del database in byte. |
||||||||||||
JET_DbInfoUpgrade |
pvResult verrà interpretato come un JET_DBINFOUPGRADE. La struttura JET_DBINFOUPGRADE verrà popolata con informazioni relative al database specificato. |
||||||||||||
JET_DbInfoMisc |
pvResult verrà interpretato come un JET_DBINFOMISC. La struttura JET_DBINFOMISC verrà popolata con informazioni relative al database specificato. |
||||||||||||
JET_DbInfoDBInUse |
pvResult verrà interpretato come BOOL (4 byte). Verrà restituito se il motore di database dispone attualmente di database aperti o collegati. Windows XP: Questo valore viene introdotto in Windows XP. |
||||||||||||
JET_DbInfoPageSize |
pvResult verrà interpretato come un long senza segno. Verranno restituite le dimensioni della pagina del database in byte. Windows XP: Questo valore viene introdotto in Windows XP. |
||||||||||||
JET_DbInfoCp |
Queste InfoLevels non sono ancora supportate e restituiscono valori predefiniti. Non usare queste InfoLevels. |
||||||||||||
JET_DbInfoCountry |
Queste InfoLevels non sono ancora supportate e restituiscono valori predefiniti. Non usare queste InfoLevels. |
||||||||||||
JET_DbInfoCollate |
Uguale a JET_DbInfoCp. |
||||||||||||
JET_DbInfoIsam |
Queste InfoLevels sono deprecate e non sono attualmente supportate. Non usare queste InfoLevels. |
||||||||||||
JET_DbInfoConnect |
Uguale a JET_DbInfoIsam. |
||||||||||||
JET_DbInfoFileType |
Windows Vista: Questo valore InfoLevel viene introdotto in Windows Vista. pvResult verrà considerato come puntatore a un DWORD. Restituisce un valore di enumerazione che indica il tipo di file che il motore considera. I tipi di file sono elencati nella tabella seguente. Per altre informazioni su questi tipi di file e sul relativo utilizzo per il motore, vedere Extensible Storage Engine Files.For more information about these types of files and their usage to the engine engine, see Extensible Storage Engine Files.
|
Valore restituito
Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.
Codice restituito |
Descrizione |
|---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errFeatureNotAvailable |
L'InfoLevel richiesto è stato JET_DbInfoIsam. Questo non è supportato. |
JET_errBufferTooSmall |
Il buffer specificato in cbMax è troppo piccolo per le informazioni desiderate. |
JET_errInvalidBufferSize |
Il buffer specificato in cbMax non è la dimensione corretta per le informazioni desiderate. |
JET_errInvalidParameter |
Uno dei parametri forniti contiene un valore imprevisto o la combinazione di diversi valori di parametro ha restituito un risultato imprevisto. Questo errore verrà restituito da JetGetDatabaseInfo quando il DBID fornito non è un database valido (collegato). Questo errore verrà restituito da JetGetDatabaseFileInfo e JetGetDatabaseInfo quando un InfoLevel richiesto non è supportato da tale versione della funzione. |
Se questa funzione ha esito positivo, i dati richiesti verranno restituiti nel buffer di output.
Se questa funzione ha esito negativo, il buffer di output sarà in uno stato non definito.
Requisiti
Client |
Richiede Windows Vista, Windows XP o Windows 2000 Professional. |
Server |
Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server. |
Intestazione |
Dichiarato in Esent.h. |
Libreria |
Usare ESENT.lib. |
DLL |
Richiede ESENT.dll. |
Unicode |
Implementato come JetGetDatabaseFileInfoW (Unicode) e JetGetDatabaseFileInfoA (ANSI). |