Funzione JetCreateIndex

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