Funzione JetAttachDatabase

Si applica a: Windows | Windows Server

Funzione JetAttachDatabase

La funzione JetAttachDatabase collega un file di database da usare con un'istanza di database. Per usare il database, sarà necessario aprirlo successivamente con JetOpenDatabase.

    JET_ERR JET_API JetAttachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

Parametri

sesid

Contesto della sessione di database da usare per la chiamata API.

szFilename

Nome del database da collegare.

grbit

Gruppo di bit che specificano zero o più delle opzioni seguenti.

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.

Commenti

La chiamata a JetAttachDatabase equivale a chiamare JetAttachDatabase2 e a passare un valore pari a zero, ovvero non esiste alcun limite per il parametro cpgDatabaseSizeMax .

Il collegamento di un database scrivibile, ovvero se JET_bitDbReadOnly non è stato specificato nel parametro grbit , aprirà il file esclusivamente a livello di sistema operativo. Nessun altro processo sarà in grado di aprire il file. È possibile che più processi connettino un singolo database aprendoli in modalità di sola lettura.

Il file di database viene scollegato usando JetDetachDatabase o JetDetachDatabase2.

Parametri di controllo dell'indice

Versioni diverse di Windows normalizzano il testo Unicode in modi diversi. Ciò significa che gli indici compilati in una versione di Windows potrebbero non funzionare in altre versioni.

Prima di Windows Server 2003, quando la versione del sistema operativo è cambiata (inclusa l'installazione di un Service Pack), ogni indice sui dati Unicode era potenzialmente danneggiato.

Gli indici creati in Windows Server 2003 e versioni successive vengono contrassegnati con la versione della normalizzazione Unicode con cui sono stati compilati. Gli indici meno recenti non contengono informazioni sulla versione. La maggior parte delle modifiche di normalizzazione Unicode consiste nell'aggiungere nuovi caratteri, i punti di codice che in precedenza non sono definiti e normalizzati in modo diverso. Pertanto, se i dati binari vengono archiviati in una colonna Unicode, verranno normalizzati in modo diverso man mano che vengono definiti nuovi punti di codice.

A partire da Windows Server 2003, il motore di database ESE tiene traccia delle voci di indice Unicode contenenti punti di codice non definiti. Questi valori possono essere usati per correggere un indice quando cambia il set di caratteri Unicode definiti.

Questi parametri controllano cosa accade quando il motore di database ESE si collega a un database usato per l'ultima volta in una build diversa del sistema operativo. La versione del sistema operativo viene contrassegnata nell'intestazione del database.

Se JET_paramEnableIndexChecking è impostato su TRUE e il database contiene indici potenzialmente danneggiati:

• JetAttachDatabase eliminerà gli indici potenzialmente danneggiati se grbit contiene JET_bitDbDeleteCorruptIndexes

• JetAttachDatabaserestituirà un errore se grbit non contiene JET_bitDbDeleteCorruptIndexes e sono presenti indici che richiedono l'eliminazione.

Se JET_paramEnableIndexChecking è impostato su FALSE:

• JetAttachDatabase ignorerà gli indici potenzialmente danneggiati e restituirà JET_errSuccess (presupponendo che non vi siano altri errori).

Windows Server 2003 e versioni successive: se JET_paramEnableIndexChecking non è stato reimpostato, la tabella di correzione interna verrà usata per correggere le voci dell'indice. Questa operazione potrebbe non correggere tutti i danneggiamenti dell'indice, ma sarà trasparente per l'applicazione.

Se il database è stato collegato come di sola lettura, l'indice non può essere corretto o eliminato. In questo caso, l'API restituirà invece un errore, ad esempio JET_errSecondaryIndexCorrupted o JET_errPrimaryIndexCorrupted.

Requisiti

Vedere anche

File del motore di archiviazione estendibili
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase2
JetCreateDatabase
JetDetachDatabase
JetDetachDatabase2
JetOpenDatabase
JetSetSystemParameter