JetRenameTable-Funktion
Gilt für: Windows | Windows Server
JetRenameTable-Funktion
Die JetRenameTable-Funktion kann verwendet werden, um den Namen einer vorhandenen Tabelle zu ändern.
JET_ERR JET_API JetRenameTable(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in const tchar* szName,
__in const tchar* szNameNew
);
Parameter
sesid
Die Sitzung, die für diesen Aufruf verwendet werden soll.
Dbid
Die Datenbank, die für diesen Aufruf verwendet werden soll.
Szname
Der aktuelle Name der Tabelle, die umbenannt wird.
szNameNew
Der neue Name für die Tabelle, die umbenannt wird.
Rückgabewert
Diese Funktion gibt den JET_ERR datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errClientRequestToStopJetService |
Es ist nicht möglich, den Vorgang abschließen, da alle Aktivitäten auf der -Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopService beendet wurden. |
JET_errInstanceUnavailable |
Der Vorgang kann nicht abgeschlossen werden, da für die der Sitzung zugeordnete Instanz ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen. Dieser Fehler wird nur von xp Windows und späteren Versionen zurückgegeben. |
JET_errInvalidDatabase |
Die angegebene Datenbank war ungültig. Dieser Fehler wird nur im Windows 2000 zurückgegeben, wenn ein Tabellenbenennungsvorgang für die temporäre Datenbank versucht wird. JET_errInvalidDatabaseId wird in späteren Versionen für diesen Fall zurückgegeben. |
JET_errInvalidDatabaseId |
Die angegebene Datenbank-ID war ungültig. |
JET_errInvalidName |
Einer der angegebenen Objektnamen war ungültig. Alle Objektnamen müssen demselben Satz von Regeln entsprechen. Nachfolgend sind diese Regeln aufgeführt:
|
JET_errInvalidParameter |
Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert oder einen Wert, der in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll war. Dies kann für JetRenameTable der Fall sein, wenn:
|
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz noch nicht initialisiert wurde. |
JET_errObjectNotFound |
Diese angegebene Tabelle ist für diese Datenbank nicht vorhanden. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die -Instanz durchgeführt wird, die der Sitzung zugeordnet ist. |
JET_errSessionSharingViolation |
Dieselbe Sitzung kann nicht gleichzeitig für mehrere Threads verwendet werden. Dieser Fehler wird nur von xp Windows und späteren Versionen zurückgegeben. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz heruntergefahren wird. |
JET_errTransReadOnly |
Ein Update kann nicht innerhalb des Bereichs einer schreibgeschützten Transaktion ausgeführt werden. Eine schreibgeschützte Transaktion ist eine Transaktion, die mit einem Aufruf von JetBeginTransaction2 mit JET_bitTransactionReadOnly. Dieser Fehler wird nur von xp Windows und späteren Versionen zurückgegeben. |
Bei Erfolg wird der Name der angegebenen Tabelle in der angegebenen Datenbank dauerhaft in den neuen Namen geändert.
Bei einem Fehler erfolgt keine Änderung des Datenbankstatus.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Header |
Wird in Esent.h deklariert. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Unicode |
Implementiert als JetRenameTableW (Unicode) und JetRenameTableA (ANSI). |