Fonction JetRenameTable
S’applique à : Windows | Windows Server
Fonction JetRenameTable
La fonction JetRenameTable peut être utilisée pour modifier le nom d’une table existante.
JET_ERR JET_API JetRenameTable(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in const tchar* szName,
__in const tchar* szNameNew
);
Paramètres
sesid
Session à utiliser pour cet appel.
dbid
Base de données à utiliser pour cet appel.
szName
Nom actuel de la table qui sera renommée.
szNameNew
Nouveau nom de la table qui sera renommée.
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_errClientRequestToStopJetService |
Il n’est pas possible d’effectuer l’opération, car toutes les activités sur le instance associées à la session ont cessé à la suite d’un appel à JetStopService. |
JET_errInstanceUnavailable |
Il n’est pas possible d’effectuer l’opération, car le instance associé à la session a rencontré une erreur irrécupérable qui exige que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures. |
JET_errInvalidDatabase |
La base de données spécifiée n’était pas valide. Cette erreur est retournée uniquement dans Windows 2000 lorsqu’une opération de renommage de table est tentée sur la base de données temporaire. JET_errInvalidDatabaseId est retourné pour ce cas dans les versions ultérieures. |
JET_errInvalidDatabaseId |
L’ID de base de données spécifié n’était pas valide. |
JET_errInvalidName |
L’un des noms d’objets spécifiés n’était pas valide. Tous les noms d’objets doivent être conformes au même ensemble de règles. Ces règles sont les suivantes :
|
JET_errInvalidParameter |
L’un des paramètres fournis contenait une valeur inattendue ou contenait une valeur qui n’était pas logique lorsqu’elle était combinée à la valeur d’un autre paramètre. Cela peut se produire pour JetRenameTable lorsque :
|
JET_errNotInitialized |
Il n’est pas possible d’effectuer l’opération, car le instance associé à la session n’a pas encore été initialisé. |
JET_errObjectNotFound |
Cette table spécifiée n’existe pas pour cette base de données. |
JET_errRestoreInProgress |
Il n’est pas possible d’effectuer l’opération, car une opération de restauration est en cours sur le instance associé à la session. |
JET_errSessionSharingViolation |
La même session ne peut pas être utilisée pour plusieurs threads en même temps. Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures. |
JET_errTermInProgress |
Il n’est pas possible d’effectuer l’opération, car le instance associé à la session est en cours d’arrêt. |
JET_errTransReadOnly |
Une mise à jour ne peut pas être effectuée à l’intérieur de l’étendue d’une transaction en lecture seule. Une transaction en lecture seule est une transaction qui a été démarrée à l’aide d’un appel à JetBeginTransaction2 avec JET_bitTransactionReadOnly. Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures. |
En cas de réussite, le nom de la table spécifiée dans la base de données donnée est définitivement remplacé par le nouveau nom.
En cas d’échec, aucune modification de l’état de la base de données ne se produit.
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 JetRenameTableW (Unicode) et JetRenameTableA (ANSI). |