Funzione JetGetDatabaseFileInfo

Articolo
06/13/2023

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.

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	Significato
JET_filetypeUnknown	Il tipo di file è sconosciuto o non è un tipo di file ESE.
JET_filetypeDatabase	Il file è un file di database.
JET_filetypeLog	Il file è un file di log delle transazioni.
JET_filetypeCheckpoint	Il file è un file di checkpoint.
JET_filetypeTempDatabase	Il file è un file di database temporaneo.

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).

Vedere anche

JET_ERR
JET_DBINFOMISC
JET_DBINFOUPGRADE
JetGetDatabaseInfo

Funzione JetGetDatabaseFileInfo