JetGetInstanceInfo-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetGetInstanceInfo-Funktion
Die Funktion JetGetInstanceInfo Ruft Informationen über die Instanzen, die ausgeführt werden.
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 Elemente in PaInstanceInfogespeicherten empfangen.
paInstanceInfo
Ein Zeiger auf einen Puffer, der die Adresse des ersten Elements eines Arrays von Strukturen empfangen.
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errInvalidParameter |
Einer der bereitgestellten Parameter einen unerwarteten Wert oder oder enthalten ein Werts, das nicht mit dem Wert eines anderen Parameters kombiniert keinen Sinn. Dieser Fehler wird zurückgegeben werden, indem JetGetInstanceInfo wenn:
|
JET_errOutOfMemory |
Es ist nicht genügend Arbeitsspeicher zum Verarbeiten der Anforderung. |
Anmerkungen
Die Datenbank-Engine wird für ein Array von Strukturen JET_INSTANCE_INFO reserviert. Der Aufrufer ist verantwortlich für diesen Speicher mit JetFreeBufferfreigeben.
Wenn keine aktiven Instanzen vorhanden sind, JetGetInstanceInfo zurückgegebenen JET_errSuccess und PcInstanceInfo einen Wert von 0 erhalten.
Voraussetzungen
-Client, |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert WindowsServer 2008 oder WindowsServer 2003. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Unicode |
Implementiert als JetGetInstanceInfoW (Unicode) und JetGetInstanceInfoA (ANSI). |