Funzione JetCreateIndex

Articolo
06/12/2023

Si applica a: Windows | Windows Server

Funzione JetCreateIndex

La funzione JetCreateIndex consente di creare un indice di dati in un database ESE (Extensible Storage Engine), che è possibile usare per individuare rapidamente dati specifici.

    JET_ERR JET_API JetCreateIndex(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_PCSTR szIndexName,
      __in          JET_GRBIT grbit,
      __in          const tchar* szKey,
      __in          unsigned long cbKey,
      __in          unsigned long lDensity
    );

Parametri

sesid

Contesto della sessione di database da usare per una determinata chiamata API.

tableid

Tabella per cui verrà creato un indice.

szIndexName

Puntatore a una stringa con terminazione Null che specifica il nome dell'indice da creare.

Il nome dell'indice deve essere conforme alle linee guida seguenti:

Deve contenere meno caratteri di JET_cbNameMost, senza includere il carattere null di terminazione.
Deve contenere solo caratteri delle categorie seguenti: da 0 a 9, da A a Z, da a z e da tutti i caratteri di punteggiatura ad eccezione di "!" (punto esclamativo), "," (virgola), "[" (parentesi quadra di apertura) e "]" (parentesi chiusa), ovvero i caratteri ASCII 0x20, 0x22 attraverso 0x2d, 0x2f attraverso 0x5a, 0x5c e 0x5d tramite 0x7f.
Non deve iniziare con uno spazio.
Deve contenere almeno un carattere diverso da uno spazio.

grbit

Gruppo di bit che contiene le opzioni da usare per una determinata chiamata. Questo parametro può includere zero o più opzioni disponibili nella struttura JET_INDEXCREATE .

szKey

Puntatore a una stringa con terminazione Null doppia di token delimitati da Null.

Per altre informazioni su questo parametro, vedere la struttura JET_INDEXCREATE .

cbKey

Lunghezza, in byte, del parametro szKey , inclusi i due caratteri Null terminanti.

lDensity

Densità percentuale dell'albero B+ indice iniziale.

Per altre informazioni su questo parametro, vedere la struttura JET_INDEXCREATE .

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti elencati nella tabella seguente. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.

Codice restituito	Significato
JET_errSuccess	Operazione riuscita.

Per un elenco di errori aggiuntivi che possono essere restituiti dalla funzione JetCreateIndex , vedere JetCreateIndex2.

Commenti

La chiamata alla funzione JetCreateIndex è identica alla chiamata della funzione JetCreateIndex2 con una struttura JET_INDEXCREATE contenente le stesse impostazioni dei parametri di JetCreateIndex e un parametro cIndexCreate uguale a 1. Per i campi della struttura JET_INDEXCREATE che non hanno parametri corrispondenti in JetCreateIndex, viene utilizzato un valore pari a 0.

Si noti che JetCreateIndex è stato sostituito da JetCreateIndex2.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Viene dichiarato in Esent.h.
Libreria	Usa ESENT.lib.
DLL	Richiede ESENT.dll.
Unicode	Viene implementato come JetCreateIndexW (Unicode) e JetCreateIndexA (ANSI).

Vedere anche

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JetCreateIndex2
JetCreateTableColumnIndex
JetCreateTableColumnIndex2

Condividi tramite

Funzione JetCreateIndex