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