Funzione JetOSSnapshotGetFreezeInfo

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetOSSnapshotGetFreezeInfo

La funzione JetOSSnapshotGetFreezeInfo recupera l'elenco di istanze e database che fanno parte della sessione snapshot in qualsiasi momento.

Windows Vista:JetOSSnapshotGetFreezeInfo è stato introdotto in Windows Vista.

    JET_ERR JET_API JetOSSnapshotGetFreezeInfo(
      __in          const JET_OSSNAPID snapId,
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo,
      __in          const JET_GRBIT grbit
    );

Parametri

snapId

Identificatore della sessione snapshot da avviare.

pcInstanceInfo

Numero di istanze attualmente in esecuzione che fanno parte della sessione snapshot.

paInstanceInfo

Matrice di strutture, una per ogni istanza in esecuzione, che descrive l'istanza e i database che ne fanno parte.

grbit

Opzioni per questa chiamata. Questo parametro è riservato per usi futuri. L'unico valore valido è 0 (zero).

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_errOutOfMemory

La funzione non è riuscita a causa di una condizione di memoria insufficiente.

JET_errInvalidParameter

pcInstanceInfo o paInstanceInfo è NULL.

JET_errOSSnapshotInvalidSnapId

L'identificatore per la sessione snapshot non è valido.

JET_errOSSnapshotInvalidSequence

Una sessione snapshot non è in corso.

Se questa funzione ha esito positivo, le informazioni sull'istanza vengono compilate correttamente e devono essere liberate in un secondo momento chiamando JetFreeBuffer con il puntatore alla matrice di informazioni sull'istanza restituita.

Se questa funzione non riesce, non viene apportata alcuna modifica allo stato del motore.

Requisiti

Requisito Valore

Client

Richiede Windows Vista.

Server

Richiede Windows Server 2008.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Unicode

Implementato come JetOSSnapshotGetFreezeInfoW (Unicode) e JetOSSnapshotGetFreezeInfoA (ANSI).

Vedere anche

Parametri di gestione degli errori
Errori del motore di archiviazione estendibile
JET_ERR
JetFreeBuffer
JetOSSnapshotAbort
JetOSSnapshotFreeze
JetOSSnapshotThaw