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:

  • Objektnamen müssen aus ASCII-Zeichen bestehen.

  • Objektnamen müssen mindestens ein Zeichen lang sein.

  • Objektnamen dürfen die Länge JET_cbNameMost (64) Zeichen nicht überschreiten.

  • Objektnamen beginnen möglicherweise nicht mit einem Leerzeichen.

  • Objektnamen dürfen keine ASCII-Steuerzeichen enthalten (0x00 bis 0x1F).

  • Objektnamen dürfen kein Ausrufezeichen (!), Punkt (.), linke Klammer ([) oder rechte Klammer (]) enthalten. Nach der Überprüfung wird nur der Teil der Zeichenfolge bis zum ersten Leerzeichen (sofern möglich) für den Objektnamen verwendet. Dies bedeutet, dass Objektnamen möglicherweise auch kein Leerzeichen enthalten.

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:

  • szName ist NULL.

  • szNameNew ist NULL.

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

Weitere Informationen

JET_DBID
JET_ERR
JET_SESID
JetBeginTransaction2