Partager via


Fonction JetGetTableIndexInfo

S’applique à : Windows | Windows Server

Fonction JetGetTableIndexInfo

La fonction JetGetTableIndexInfo récupère des informations sur un index.

    JET_ERR JET_API JetGetTableIndexInfo(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          const tchar* szIndexName,
      __out         void* pvResult,
      __in          unsigned long cbResult,
      __in          unsigned long InfoLevel
    );

Paramètres

sesid

Contexte de session de base de données à utiliser pour l’appel d’API.

tableid

Table de base de données qui contient l’index contenant les informations nécessaires.

szIndexName

Nom de l’index qui contient les informations qui seront récupérées.

pvResult

Pointeur vers une mémoire tampon qui recevra les informations. La mémoire tampon doit être alignée pour contenir le type requis. Le type de la mémoire tampon dépend du paramètre InfoLevel .

cbResult

Taille, en octets, de la mémoire tampon passée dans le paramètre pvResult .

InfoLevel

Spécifie les informations qui seront stockées dans pvResult. Les valeurs valides sont les suivantes :

Valeur

Signification

JET_IdxInfo

pvResult est interprété comme une structure JET_INDEXLIST . En cas de réussite, la structure JET_INDEXLIST reçoit des informations sur l’index. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoLCID

pvResult est interprété comme un LCID. En cas de réussite, le LCID contient l’identificateur de paramètres régionaux de l’index. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoList

pvResult est interprété comme une structure JET_INDEXLIST . En cas de réussite, la structure JET_INDEXLIST reçoit des informations sur l’index. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoOLC

JET_IdxInfoOLC est obsolète.

JET_IdxInfoResetOLC

JET_IdxInfoResetOLC est obsolète.

JET_IdxInfoSpaceAlloc

pvResult est interprété comme un ULONG. En cas de réussite, l’ULONG conserve l’utilisation de l’espace de l’index. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoSysTabCursor

JET_IdxInfoSysTabCursor est obsolète.

JET_IdxInfoLangid

JET_IdxInfoLangid est déconseillé. Utilisez JET_IdxInfoLCID à la place et la macro LANGIDFROMLCID à la place.

JET_IdxInfoCount

pvResult est interprété comme un ULONG. En cas de réussite, l’ULONG conserve le nombre d’index sur la table spécifiée. szIndexName est ignoré. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoVarSegMac

pvResult est interprété comme un USHORT. En cas de réussite, l’USHORT conserve la valeur cbVarSegMac utilisée lors de la création de l’index. Consultez JET_INDEXCREATE pour obtenir une description de cbVarSegMac. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoIndexId

pvResult est interprété comme un JET_INDEXID. En cas de réussite, la structure JET_INDEXID reçoit des informations sur l’index. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoKeyMost

pvResult est interprété comme un USHORT. En cas de réussite, L’USHORT contient la valeur cbKeyMost utilisée lors de la création de l’index. Consultez la structure JET_INDEXCREATE pour obtenir une description de cbKeyMost. En cas d’échec, le contenu de pvBuffer n’est pas défini.

JET_IdxInfoCreateIndex

pvResult est interprété comme une structure JET_INDEXCREATE . En cas d’échec, le contenu de pvBuffer n’est pas défini.

Windows 7 : JET_IdxInfoCreateIndex est introduit dans Windows 7.

JET_IdxInfoCreateIndex2

pvResult est interprété comme une structure JET_INDEXCREATE2 . En cas d’échec, le contenu de pvBuffer n’est pas défini.

Windows 7 : JET_IdxInfoCreateIndex2 est introduit dans Windows 7.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. Pour plus d’informations sur les erreurs ESE possibles, consultez Erreurs du moteur de stockage extensible et Paramètres de gestion des erreurs.

Code de retour

Description

JET_errSuccess

L’opération s’est terminée avec succès.

JET_errIndexNotFound

L’index spécifié est introuvable dans la table spécifiée.

JET_wrnBufferTruncated

La mémoire tampon passée en tant que pvResult était trop petite. Le contenu de la mémoire tampon n’est pas défini.

Notes

JetGetIndexInfo et JetGetTableIndexInfo récupèrent des informations identiques sur un index. La différence réside dans la façon dont la table est spécifiée. JetGetIndexInfo attend une base de données (dbid) et le nom d’une table (szTableName), tandis que JetGetTableIndexInfo attend un identificateur de table (tableid).

Spécifications

Condition requise Valeur

Client

Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.

Serveur

Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.

En-tête

Déclaré dans Esent.h.

Bibliothèque

Utilisez ESENT.lib.

DLL

Nécessite ESENT.dll.

Unicode

Implémenté en tant que JetGetTableIndexInfoW (Unicode) et JetGetTableIndexInfoA (ANSI).

Voir aussi

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JET_INDEXID
JetGetIndexInfo