JetOSSnapshotGetFreezeInfo-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetOSSnapshotGetFreezeInfo-Funktion

Die JetOSSnapshotGetFreezeInfo-Funktion ruft jederzeit die Liste der Instanzen und Datenbanken ab, die Teil der Momentaufnahme-Sitzung sind.

Windows Vista:JetOSSnapshotGetFreezeInfo wird in Windows Vista eingeführt.

    JET_ERR JET_API JetOSSnapshotGetFreezeInfo(
      __in          const JET_OSSNAPID snapId,
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo,
      __in          const JET_GRBIT grbit
    );

Parameter

snapId

Der Bezeichner der Momentaufnahme-Sitzung, die gestartet werden soll.

pcInstanceInfo

Die Anzahl der derzeit ausgeführten Instanzen, die Teil der Momentaufnahme-Sitzung sind.

paInstanceInfo

Ein Array von Strukturen, eine für jede ausgeführte instance, die die instance und die Datenbanken beschreibt, die teil davon sind.

grbit

Die Optionen für diesen Aufruf. Dieser Parameter ist für die zukünftige Verwendung reserviert. Der einzige gültige Wert ist 0 (null).

Rückgabewert

Diese Funktion gibt den JET_ERR-Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errOutOfMemory

Die Funktion ist aufgrund einer Nicht-Speicherbedingung fehlgeschlagen.

JET_errInvalidParameter

pcInstanceInfo oder paInstanceInfo ist NULL.

JET_errOSSnapshotInvalidSnapId

Der Bezeichner für die Momentaufnahme Sitzung ist ungültig.

JET_errOSSnapshotInvalidSequence

Eine Momentaufnahme Sitzung wird nicht ausgeführt.

Wenn diese Funktion erfolgreich ist, wird die instance Informationen ordnungsgemäß ausgefüllt und muss später durch Aufrufen von JetFreeBuffer mit dem Zeiger auf das zurückgegebene instance Infoarray freigegeben werden.

Wenn diese Funktion fehlschlägt, tritt keine Änderung des Engine-Zustands auf.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista.

Server

Erfordert Windows Server 2008.

Kopfzeile

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Unicode

Implementiert als JetOSSnapshotGetFreezeInfoW (Unicode) und JetOSSnapshotGetFreezeInfoA (ANSI).

Weitere Informationen

Fehlerbehandlungsparameter
Erweiterbare Speicher-Engine-Fehler
JET_ERR
JetFreeBuffer
JetOSSnapshotAbort
JetOSSnapshotFreeze
JetOSSnapshotThaw