Función JetOSSnapshotGetFreezeInfo

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetOSSnapshotGetFreezeInfo

La función JetOSSnapshotGetFreezeInfo recupera la lista de instancias y bases de datos que forman parte de la sesión de instantáneas en un momento dado.

Windows Vista:JetOSSnapshotGetFreezeInfo se presenta en 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
    );

Parámetros

snapId

Identificador de la sesión de instantáneas que se va a iniciar.

pcInstanceInfo

Número de instancias que se ejecutan actualmente que forman parte de la sesión de instantáneas.

paInstanceInfo

Matriz de estructuras, una para cada instancia en ejecución, que describe la instancia y las bases de datos que forman parte de ella.

grbit

Las opciones de esta llamada. Este parámetro se reserva para uso futuro. El único valor válido es 0 (cero).

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errOutOfMemory	Error en la función debido a una condición de memoria insuficiente.
JET_errInvalidParameter	pcInstanceInfo o paInstanceInfo es NULL.
JET_errOSSnapshotInvalidSnapId	El identificador de la sesión de instantáneas no es válido.
JET_errOSSnapshotInvalidSequence	Una sesión de instantánea no está en curso.

Si esta función se realiza correctamente, la información de la instancia se rellena correctamente y se debe liberar más adelante llamando a JetFreeBuffer con el puntero a la matriz de información de instancia que se devolvió.

Si se produce un error en esta función, no se produce ningún cambio en el estado del motor.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista.
Servidor	Requiere Windows Server 2008.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetOSSnapshotGetFreezeInfoW (Unicode) y JetOSSnapshotGetFreezeInfoA (ANSI).

Consulte también

Parámetros de control de errores
Errores del motor de almacenamiento extensible
JET_ERR
JetFreeBuffer
JetOSSnapshotAbort
JetOSSnapshotFreeze
JetOSSnapshotThaw

Compartir a través de

Función JetOSSnapshotGetFreezeInfo