Fonction JetDeleteColumn2
S’applique à : Windows | Windows Server
Fonction JetDeleteColumn2
La fonction JetDeleteColumn2 supprime une colonne d’une table de base de données ESE et permet de définir une option grbit .
Windows XP : JetDeleteColumn2 est introduit dans Windows XP.
JET_ERR JET_API JetDeleteColumn2(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName,
__in const JET_GRBIT grbit
);
Paramètres
sesid
Contexte de session de base de données à utiliser pour l’appel d’API.
tableid
Table qui contient la colonne à supprimer.
szColumnName
Nom de la colonne à supprimer.
grbit
Groupe de bits spécifiant zéro ou plusieurs des options suivantes.
Valeur |
Signification |
|---|---|
JET_bitDeleteColumnIgnoreTemplateColumns |
Si vous définissez JET_bitDeleteColumIgnoreTemplateColumns, l’API tente uniquement de supprimer des colonnes dans la table dérivée. Si une colonne de ce nom existe dans la table de base, elle sera ignoré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_errColumnInUse |
La colonne est actuellement utilisée. Il peut être actuellement utilisé par un index. |
JET_errFixedDDL |
Une tentative de modification du 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 ou Windows XP. |
Serveur |
Nécessite Windows Server 2008 ou Windows Server 2003. |
En-tête |
Déclaré dans Esent.h. |
Bibliothèque |
Utilisez ESENT.lib. |
DLL |
Nécessite ESENT.dll. |
Unicode |
Implémenté en tant que JetDeleteColumn2W (Unicode) et JetDeleteColumn2A (ANSI). |