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 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_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 zum Verarbeiten der Anforderung vorhanden. |
Bemerkungen
Die Datenbank-Engine ordnet ein Array von JET_INSTANCE_INFO Strukturen zu. Der Aufrufer ist dafür verantwortlich, diesen Arbeitsspeicher mit JetFreeBufferfreizugeben.
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. |
Header |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Unicode |
Wird als JetGetInstanceInfoW (Unicode) und JetGetInstanceInfoA (ANSI) implementiert. |