Funzione JetDeleteColumn2
Si applica a: Windows | Windows Server
Funzione JetDeleteColumn2
La funzione JetDeleteColumn2 elimina una colonna da una tabella di database ESE e consente di impostare un'opzione grbit .
Windows XP: JetDeleteColumn2 viene introdotto in Windows XP.
JET_ERR JET_API JetDeleteColumn2(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName,
__in const JET_GRBIT grbit
);
Parametri
sesid
Contesto della sessione di database da usare per la chiamata API.
tableid
Tabella contenente la colonna da eliminare.
szColumnName
Nome della colonna da eliminare.
grbit
Un gruppo di bit che specificano zero o più delle opzioni seguenti.
Valore |
Significato |
|---|---|
JET_bitDeleteColumnIgnoreTemplateColumns |
L'impostazione JET_bitDeleteColumIgnoreTemplateColumns causerà che l'API tenterà solo di eliminare colonne nella tabella derivata. Se una colonna di tale nome esiste nella tabella di base verrà ignorata. |
Valore restituito
Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.
Codice restituito |
Descrizione |
|---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errColumnInUse |
La colonna è attualmente in uso. Può essere attualmente usato da un indice. |
JET_errFixedDDL |
È stato effettuato un tentativo di modifica del DDL fisso. |
JET_errFixedInheritedDDL |
La colonna denominata in szColumnName esiste nella tabella modello e non è possibile modificare il DDL di una tabella modello. |
JET_errInvalidName |
Può essere restituito se è stato specificato un nome non valido per szColumnName . |
JET_errPermissionDenied |
La tabella non è scrivibile. Questo può essere restituito se il database è stato aperto in modalità di sola lettura. |
JET_errTransReadOnly |
La transazione è una transazione di sola lettura. |
Commenti
La chiamata a JetDeleteColumn è identica alla chiamata di JetDeleteColumn2 con grbit impostata su zero (0).
Requisiti
| Requisito | Valore |
|---|---|
Client |
Richiede Windows Vista o Windows XP. |
Server |
Richiede Windows Server 2008 o Windows Server 2003. |
Intestazione |
Dichiarato in Esent.h. |
Libreria |
Usare ESENT.lib. |
DLL |
Richiede ESENT.dll. |
Unicode |
Implementato come JetDeleteColumn2W (Unicode) e JetDeleteColumn2A (ANSI). |