Partager via


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).

Voir aussi

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetDeleteColumn2