JetGetInstanceInfo-Funktion

Artikel
06/13/2023

Gilt für: Windows | Windows Server

JetGetInstanceInfo-Funktion

Die JetGetInstanceInfo-Funktion ruft Informationen zu den ausgeführten Instanzen ab.

Windows XP: JetGetInstanceInfo wird in Windows XP eingeführt.

    JET_ERR JET_API JetGetInstanceInfo(
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo
    );

Parameter

pcInstanceInfo

Ein Zeiger auf einen Puffer, der die Anzahl der in paInstanceInfo gespeicherten Elemente empfängt.

paInstanceInfo

Ein Zeiger auf einen Puffer, der die Adresse des ersten Elements eines Arrays von Strukturen empfängt.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR 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_errInvalidParameter	Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert oder einen Wert, der in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll war. Dieser Fehler wird von JetGetInstanceInfo zurückgegeben, wenn: pcInstanceInfo oder paInstanceInfo sind NULL.
JET_errOutOfMemory	Es ist nicht genügend Arbeitsspeicher vorhanden, um die Anforderung zu verarbeiten.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

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. Dieser Fehler wird von JetGetInstanceInfo zurückgegeben, wenn:

pcInstanceInfo oder paInstanceInfo sind NULL.

JET_errOutOfMemory

Es ist nicht genügend Arbeitsspeicher vorhanden, um die Anforderung zu verarbeiten.

Bemerkungen

Die Datenbank-Engine ordnet ein Array von JET_INSTANCE_INFO Strukturen zu. Der Aufrufer ist dafür verantwortlich, diesen Arbeitsspeicher mit JetFreeBuffer freizugeben.

Wenn keine aktiven Instanzen vorhanden sind, gibt JetGetInstanceInfo JET_errSuccess zurück, und pcInstanceInfo erhält den Wert 0.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.
Unicode	Implementiert als JetGetInstanceInfoW (Unicode) und JetGetInstanceInfoA (ANSI).

Weitere Informationen

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer

JetGetInstanceInfo-Funktion