Condividi tramite

Funzione JetGetInstanceInfo

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetGetInstanceInfo

La funzione JetGetInstanceInfo recupera informazioni sulle istanze in esecuzione.

Windows XP: JetGetInstanceInfo è stato introdotto in Windows XP.

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

Parametri

pcInstanceInfo

Puntatore a un buffer che riceverà il numero di elementi archiviati in paInstanceInfo.

paInstanceInfo

Puntatore a un buffer che riceverà l'indirizzo del primo elemento di una matrice di strutture.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errInvalidParameter

Uno dei parametri forniti conteneva un valore imprevisto o conteneva un valore che non ha senso se combinato con il valore di un altro parametro. Questo errore verrà restituito da JetGetInstanceInfo quando:

  • pcInstanceInfo o paInstanceInfo sono NULL.

JET_errOutOfMemory

Memoria insufficiente per elaborare la richiesta.

Commenti

Il motore di database allocherà una matrice di strutture JET_INSTANCE_INFO . Il chiamante è responsabile della liberazione di questa memoria con JetFreeBuffer.

Se non sono presenti istanze attive, JetGetInstanceInfo restituirà JET_errSuccess e pcInstanceInfo riceverà il valore 0.

Requisiti

Requisito Valore

Client

Richiede Windows Vista o Windows XP.

Server

Richiede Windows Server 2008 o Windows Server 2003.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Unicode

Implementato come JetGetInstanceInfoW (Unicode) e JetGetInstanceInfoA (ANSI).

Vedere anche

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer