Fonction JetDeleteColumn
S’applique à : Windows | Windows Server
Fonction JetDeleteColumn
La fonction JetDeleteColumn supprime une colonne d’une table de base de données ESE.
JET_ERR JET_API JetDeleteColumn(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName
);
Paramètres
sesid
Contexte de session de base de données à utiliser pour l’appel d’API.
tableid
Table à partir de laquelle supprimer la colonne.
szColumnName
Nom de la colonne à 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_errColumnInUse |
La colonne est en cours d’utilisation. Il peut être actuellement utilisé par un index. |
JET_errFixedDDL |
Une tentative de modification de la DDL fixe a été effectuée. |
JET_errFixedInheritedDDL |
La colonne nommée dans szColumnName existe dans la table de modèle et le DDL d’une table de modèle ne peut pas être modifié. |
JET_errInvalidName |
Cela peut être retourné si un nom incorrect pour szColumnName a été donné. |
JET_errPermissionDenied |
La table n’est pas accessible en écriture. Cela peut être retourné si la base de données a été ouverte en mode lecture seule. |
JET_errTransReadOnly |
La transaction est une transaction en lecture seule. |
Notes
L’appel de JetDeleteColumn est identique à l’appel de JetDeleteColumn2 avec grbit défini sur zéro (0).
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 JetDeleteColumnW (Unicode) et JetDeleteColumnA (ANSI). |