Fonction JetDeleteIndex
S’applique à : Windows | Windows Server
Fonction JetDeleteIndex
La fonction JetDeleteIndex supprime un index d’une table.
JET_ERR JET_API JetDeleteIndex(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_PCSTR szIndexName
);
Paramètres
sesid
Contexte de session de base de données à utiliser pour l’appel d’API.
tableid
Table qui contient la colonne à supprimer.
szIndexName
Nom de l’index à supprimer.
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_errFixedDDL |
Une tentative de suppression d’un index d’une table fixe (par exemple, un index créé avec JET_bitTableCreateFixedDDL). |
JET_errFixedInheritedDDL |
Une tentative de suppression d’un index d’une table de modèle a été effectuée. Une table de modèle a un DDL fixe. |
JET_errIndexNotFound |
L’index nommé dans szIndexName est introuvable. |
JET_errPermissionDenied |
La table ne peut pas être mise à jour, car elle a été ouverte en lecture seule. |
JET_errSessionSharingViolation |
Plusieurs threads ont tenté d’utiliser la même session de base de données. |
JET_errTransReadOnly |
La transaction a été ouverte en tant que transaction en lecture seule. |
Notes
En cas de réussite, l’index est supprimé et ne peut donc pas être utilisé par la suite. Il ne doit pas y avoir de transaction active à l’aide de l’index.
En cas de réussite, la devise est définie avant le premier enregistrement.
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 JetDeleteIndexW (Unicode) et JetDeleteIndexA (ANSI). |
Voir aussi
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCreateIndex
JetCreateIndex2