Windows Dev Center

Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetSetColumnDefaultValue-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

Die JetSetColumnDefaultValue -Funktion kann verwendet werden, um den Standardwert einer vorhandenen Spalte ändern.

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

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

DBID

Die Datenbank für diesen Aufruf verwenden.

szTableName

Der Name der Tabelle mit der Spalte, die betroffen sind.

szColumnName

Der Name der Spalte, deren Standardwert geändert wird.

pvData

Der Eingabepuffer, der den neue Standardwert enthält.

cbData

Die Größe des Eingabepuffers, der den neue Standardwert enthält.

JET_errInvalidGrbit

Für die zukünftige Verwendung reserviert.

Return Value

Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Es ist nicht möglich, um den Vorgang abzuschließen, da alle Aktivitäten in der Instanz dieser Sitzung aufgrund eines Aufrufs von JetStopServiceeingestellt hat.

JET_errColumnIllegalNull

Identisch mit JET_errNullInvalid.

JET_errColumnInUse

Dieser angegebene Spalte wird derzeit von einem Index verwendet.

JetSetColumnDefaultValue kann nicht den Standardwert einer Spalte ändern, die in der Definition eines Index verwiesen wird. Dies ist, da dies so den Inhalt des Indexes ändern könnte.

JET_errColumnNotFound

Dieser angegebene Spalte existiert nicht für diese Tabelle.

JET_errInstanceUnavailable

Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz ein schwerwiegender Fehler, der erfordert aufgetreten ist, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben werden.

JET_errInvalidDatabaseId

Die angegebene Datenbank-ID ist ungültig.

JET_errInvalidName

Einer der angegebenen Objektnamen ist ungültig. Alle Objektnamen müssen den gleichen Satz von Regeln entsprechen. Diese Regeln sind wie folgt:

  • Objektnamen müssen aus ASCII-Zeichen bestehen.

  • Objektnamen müssen mindestens ein Zeichen lang sein.

  • Objektnamen können JET_cbNameMost (64) Zeichen nicht überschreiten.

  • Objektnamen dürfen nicht mit einem Leerzeichen beginnen.

  • Objektnamen dürfen nicht ASCII-Steuerzeichen (0 x 00 bis 0x1F).

  • Objektnamen dürfen kein Ausrufezeichen (!), Punkt (.), Links eckige Klammer ([]) oder Rechte eckige Klammer (]) Zeichen.

  • Nach der Bestätigung, wird nur der Teil der Zeichenfolge bis zum ersten Leerzeichen (sofern vorhanden) für die zu verwendenden Objektnamen verwendet werden. Dies bedeutet, dass die Objektnamen keine entweder ein Leerzeichen enthalten dürfen.

JET_errNotInitialized

Es ist nicht möglich, um den Vorgang abzuschließen, da die Instanz dieser Sitzung noch nicht initialisiert wurde.

JET_errNullInvalid

Die Spalte kann nicht auf NULL festgelegt werden. In diesem Fall für JetSetColumnDefaultValue bei:

  • CbData ist 0 (null).

  • PvData ist NULL.

Daher ist es nicht möglich, den Standardwert einer Spalte (Rückseite) auf NULL oder einen Längenwert 0 (null) festgelegt.

JET_errObjectNotFound

Dieser angegebene Tabelle ist für diese Datenbank nicht vorhanden.

JET_errRestoreInProgress

Es ist nicht möglich, um den Vorgang abzuschließen, da ein Wiederherstellungsvorgang ausgeführt auf die Instanz der Sitzung zugeordnet wird.

JET_errSessionSharingViolation

Die gleiche Sitzung kann für mehrere Threads gleichzeitig verwendet werden. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben werden.

JET_errTableInUse

Dieser angegebene Tabelle ist von einer anderen Sitzung verwendet.

JetSetColumnDefaultValue erfordert exklusiven Zugriff auf eine Tabelle, um den Standardwert der Spalte Versionen vor Windows Server 2003 ändern.

JET_errTermInProgress

Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz heruntergefahren wird.

JET_errTransReadOnly

Es ist unzulässig, wenn innerhalb des Bereichs der Transaktion read nur eine Aktualisierung versuchen. Eine Lese nur Transaktion ist eine Transaktion, die mit einem Aufruf von JetBeginTransaction2 mit JET_bitTransactionReadOnly gestartet wurde. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben werden.

JET_errWriteConflict

Eine andere Sitzung hat den Datensatz für das Update bereits gesperrt. Das Update von der Sitzung versucht, schlägt fehl.

Bei Erfolg wird der Standardwert der angegebenen Spalte in der angegebenen Tabelle in der Datenbank dauerhaft auf den neuen Standardwert geändert.

Bei einem Fehler wird keine Änderung an den Zustand der Datenbank auftreten.

Anmerkungen

Es ist nicht möglich, den Standardwert einer Spalte in einer Vorlagentabelle ändern.

Die Datenbank-Engine kürzt den Standardwert einer Spalte auf 255 Byte langen Text und long binary-Spalten automatisch.

Voraussetzungen

-Client,

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server.

Kopfzeile

In Esent.h deklariert.

Library

Verwenden Sie ESENT.lib.

DLL

"ESENT.dll" erfordert.

Unicode

Implementiert als JetSetColumnDefaultValueW (Unicode) und JetSetColumnDefaultValueA (ANSI).

Siehe auch

Anzeigen:
© 2015 Microsoft