JetSetColumnDefaultValue fonction)
S’applique à : Windows | Windows Serveurs
JetSetColumnDefaultValue fonction)
La fonction JetSetColumnDefaultValue peut être utilisée pour modifier la valeur par défaut d’une colonne existante.
JET_ERR JET_API JetSetColumnDefaultValue(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in JET_PCSTR szTableName,
__in JET_PCSTR szColumnName,
__in const void* pvData,
__in const unsigned long cbData,
__in const JET_GRBIT grbit
);
Paramètres
sesid
Session à utiliser pour cet appel.
dbid
Base de données à utiliser pour cet appel.
szTableName
Nom de la table contenant la colonne qui sera affectée.
szColumnName
Nom de la colonne dont la valeur par défaut sera modifiée.
pvData
Mémoire tampon d’entrée contenant la nouvelle valeur par défaut.
cbData
Taille de la mémoire tampon d’entrée contenant la nouvelle valeur par défaut.
grbit
Réservé pour un usage futur.
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 de terminer l’opération, car toute activité sur l’instance associée à la session a été interrompue suite à un appel à JetStopService. |
JET_errColumnIllegalNull |
Identique à JET_errNullInvalid. |
JET_errColumnInUse |
Cette colonne spécifiée est actuellement utilisée par un index. JetSetColumnDefaultValue ne peut pas modifier la valeur par défaut d’une colonne référencée dans la définition d’un index. Cela est dû au fait que cela peut modifier le contenu de l’index. |
JET_errColumnNotFound |
La colonne spécifiée n’existe pas pour cette table. |
JET_errInstanceUnavailable |
Il n’est pas possible de terminer l’opération, car l’instance associée à la session a rencontré une erreur irrécupérable qui requiert que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. cette erreur est renvoyée uniquement par Windows XP et les versions ultérieures. |
JET_errInvalidDatabaseId |
L’ID de base de données spécifié n’est pas valide. |
JET_errInvalidName |
L’un des noms d’objets spécifiés n’est pas valide. Tous les noms d’objets doivent être conformes au même ensemble de règles. Ces règles sont les suivantes :
|
JET_errNotInitialized |
Impossible de terminer l’opération, car l’instance associée à la session n’a pas encore été initialisée. |
JET_errNullInvalid |
La colonne n’a pas pu être définie sur NULL. Cela se produit pour JetSetColumnDefaultValue dans les cas suivants :
Par conséquent, il n’est pas possible de définir la valeur par défaut d’une colonne (arrière) sur NULL ou sur une valeur de longueur nulle. |
JET_errObjectNotFound |
La table spécifiée n’existe pas pour cette base de données. |
JET_errRestoreInProgress |
Il n’est pas possible de terminer l’opération, car une opération de restauration est en cours sur l’instance associée à la session. |
JET_errSessionSharingViolation |
La même session ne peut pas être utilisée simultanément pour plusieurs threads. cette erreur est renvoyée uniquement par Windows XP et les versions ultérieures. |
JET_errTableInUse |
Cette table spécifiée est utilisée par une autre session. JetSetColumnDefaultValue requiert un accès exclusif à une table afin de modifier la valeur par défaut de la colonne pour les versions antérieures à Windows Server 2003. |
JET_errTermInProgress |
Il n’est pas possible de terminer l’opération, car l’instance associée à la session est en cours d’arrêt. |
JET_errTransReadOnly |
Il n’est pas autorisé de tenter une mise à jour dans 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 est renvoyée uniquement par Windows XP et les versions ultérieures. |
JET_errWriteConflict |
Une autre session a déjà verrouillé l’enregistrement pour la mise à jour. La mise à jour tentée par cette session échoue. |
En cas de réussite, la valeur par défaut de la colonne spécifiée dans la table donnée dans la base de données donnée est remplacée définitivement par la nouvelle valeur par défaut.
En cas d’échec, aucune modification de l’état de la base de données ne se produit.
Notes
Il n’est pas possible de modifier la valeur par défaut d’une colonne dans une table de modèle.
Le moteur de base de données tronque en mode silencieux la valeur par défaut d’une colonne à 255 octets pour les colonnes de type long text et long Binary.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista, Windows XP ou Windows 2000 Professional. |
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 |
Requiert ESENT.dll. |
Unicode |
Implémenté en tant que JetSetColumnDefaultValueW (Unicode) et JetSetColumnDefaultValueA (ANSI). |
Voir aussi
JET_DBID
JET_ERR
JET_GRBIT
JET_SESID
JetBeginTransaction2
JetStopService