JetGetInstanceInfo-Funktion
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:
|
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). |