Funzione JetGetIndexInfo

Articolo
06/13/2023

Si applica a: Windows | Windows Server

Funzione JetGetIndexInfo

La funzione JetGetIndexInfo recupera informazioni su un indice.

    JET_ERR JET_API JetGetIndexInfo(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szTableName,
      __in          const tchar* szIndexName,
      __out         void* pvResult,
      __in          unsigned long cbResult,
      __in          unsigned long InfoLevel
    );

Parametri

sesid

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

dbid

Identificatore del database da usare per la chiamata API.

szTableName

Nome della tabella contenente l'indice con le informazioni da recuperare.

szIndexName

Nome dell'indice con le informazioni da recuperare.

pvResult

Puntatore a un buffer che riceverà le informazioni desiderate. Il buffer deve essere allineato per contenere il tipo richiesto. Il tipo del buffer dipende dal parametro InfoLevel .

cbResult

Dimensione, in byte, del buffer passato come pvResult.

InfoLevel

Informazioni che verranno archiviate in pvResult. Per questo parametro è possibile usare le opzioni seguenti.

Valore	Significato
JET_IdxInfo	pvResult viene interpretato come struttura JET_INDEXLIST . In caso di esito positivo, la struttura JET_INDEXLIST riceve informazioni sull'indice. In caso di errore, il contenuto di pvBuffer non è definito.
JET_IdxInfoCount	pvResult viene interpretato come ULONG. In caso di esito positivo, ULONG contiene il conteggio degli indici nella tabella specificata. szIndexName viene ignorato. In caso di errore, il contenuto di pvBuffer non è definito.
JET_IdxInfoIndexId	pvResult viene interpretato come un JET_INDEXID. In caso di esito positivo, la struttura JET_INDEXID riceve informazioni sull'indice. In caso di errore, il contenuto di pvBuffer non è definito.
JET_IdxInfoLangid	JET_IdxInfoLangid è deprecato. Usare invece JET_IdxInfoLCID e la macro LANGIDFROMLCID .
JET_IdxInfoLCID	pvResult viene interpretato come LCID. In caso di esito positivo, LCID contiene l'identificatore delle impostazioni locali dell'indice. In caso di errore, il contenuto di pvBuffer non è definito. Windows XP: JET_IdxInfoLCID è stato introdotto in Windows XP.
JET_IdxInfoList	pvResult viene interpretato come struttura JET_INDEXLIST . In caso di esito positivo, la struttura JET_INDEXLIST riceve informazioni sull'indice. In caso di errore, il contenuto di pvBuffer non è definito.
JET_IdxInfoOLC	JET_IdxInfoOLC è obsoleto.
JET_IdxInfoResetOLC	JET_IdxInfoResetOLC è obsoleto.
JET_IdxInfoSpaceAlloc	pvResult viene interpretato come ULONG. In caso di esito positivo, ULONG mantiene l'utilizzo dello spazio dell'indice. In caso di errore, il contenuto di pvBuffer non è definito.
JET_IdxInfoSysTabCursor	JET_IdxInfoSysTabCursor è obsoleto.
JET_IdxInfoVarSegMac	pvResult viene interpretato come USHORT. In caso di esito positivo, USHORT contiene il valore di cbVarSegMac usato al momento della creazione dell'indice. Vedere JET_INDEXCREATE per una descrizione di cbVarSegMac. In caso di errore, il contenuto di pvBuffer non è definito.
JET_IdxInfoKeyMost	pvResult viene interpretato come USHORT. In caso di esito positivo, USHORT contiene il valore cbKeyMost usato al momento della creazione dell'indice. Per una descrizione di cbKeyMost, vedere JET_INDEXCREATE. In caso di errore, il contenuto di pvBuffer non è definito. Windows Vista: JET_IdxInfoKeyMost è stato introdotto in Windows Vista.
JET_IdxInfoCreateIndex	pvResult viene interpretato come struttura JET_INDEXCREATE . In caso di errore, il contenuto di pvBuffer non è definito. Windows 7: JET_IdxInfoCreateIndex è stato introdotto in Windows 7.
JET_IdxInfoCreateIndex2	pvResult viene interpretato come struttura JET_INDEXCREATE2 . In caso di errore, il contenuto di pvBuffer non è definito. Windows 7: JET_IdxInfoCreateIndex2 è stato introdotto in Windows 7.

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_errIndexNotFound	Impossibile trovare l'indice specificato nella tabella specificata.
JET_wrnBufferTruncated	Il buffer passato come pvResult era troppo piccolo. Il contenuto del buffer non è definito.

Commenti

JetGetIndexInfo e JetGetTableIndexInfo recuperano informazioni identiche su un indice. La differenza consiste nel modo in cui viene specificata la tabella. JetGetIndexInfo prevede un database (dbid) e il nome di una tabella (szTableName), mentre JetGetTableIndexInfo prevede un identificatore di tabella (tableid).

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	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.
Unicode	Implementato come JetGetIndexInfoW (Unicode) e JetGetIndexInfoA (ANSI).

Vedere anche

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_INDEXID
JET_SESID
JET_TABLEID
JetGetTableIndexInfo

Condividi tramite

Funzione JetGetIndexInfo