Función JetInit2

Se aplica a: Windows | Windows Server

Función JetInit2

La función JetInit2 coloca el motor de base de datos en un estado en el que puede admitir el uso de aplicaciones de archivos de base de datos. El motor ya debe estar configurado correctamente para la inicialización mediante JetSetSystemParameter. La recuperación de bloqueos de base de datos se realiza automáticamente como parte del proceso de inicialización.

Windows XP:JetInit2 se presenta en Windows XP.

Esta función está obsoleta. Use JetInit3 en su lugar.

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

Parámetros

pinstance

Instancia que se va a usar para esta llamada.

Para Windows 2000, este parámetro se omite y siempre debe ser NULL.

Para Windows XP y versiones posteriores, el uso de este parámetro depende del modo de funcionamiento del motor. Si el motor funciona en modo heredado (modo de compatibilidad de Windows 2000) donde solo se admite una instancia, este parámetro puede ser NULL o puede establecerse en un búfer de salida válido que contenga NULL o JET_instanceNil que devuelva el identificador de instancia global creado como efecto secundario de la inicialización. A continuación, este identificador de instancia se puede pasar a cualquier otra API que tome una instancia. Si el motor funciona en modo de varias instancias, este parámetro debe establecerse en un búfer de entrada válido que contenga el identificador de instancia devuelto por jetCreateInstance que se está inicializando.

grbit

Un grupo de bits que especifica cero o más de las siguientes opciones.

Value	Significado
JET_bitReplayReplicatedLogFiles	Reservado para uso futuro.
JET_bitCreateSFSVolumeIfNotExist	Reservado para uso futuro.
JET_bitReplayIgnoreMissingDB	Esta opción permite al usuario ejecutar la recuperación en un conjunto de archivos de registro, sin que todas las bases de datos estén presentes, que se adjuntaron en un punto del conjunto de registros.
JET_bitRecoveryWithoutUndo	Realice la recuperación, pero se detenga en la fase Deshacer. Esto permite que los registros de transacciones adicionales se copien en y se apliquen.
JET_bitTruncateLogsAfterRecovery	Si la recuperación temporal se realiza correctamente, trunca los archivos de registro.
JET_bitReplayMissingMapEntryDB	Falta la entrada de mapa de base de datos de forma predeterminada en la misma ubicación.
JET_bitReplayIgnoreLostLogs	Omita los registros perdidos del final de la secuencia de registro. Windows 7:JET_bitReplayIgnoreLostLogs se introduce en Windows 7.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR 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.

Comentarios

Una instancia debe inicializarse con una llamada a JetInit2 antes de que pueda usarse con cualquier otra cosa que no sea JetSetSystemParameter.

Una instancia se destruye mediante una llamada a la función JetTerm , incluso si esa instancia nunca se inicializó mediante JetInit. Una instancia es la unidad de capacidad de recuperación para el motor de base de datos. Controla el ciclo de vida de todos los archivos utilizados para proteger la integridad de los datos en un conjunto de archivos de base de datos. Estos archivos incluyen el archivo de punto de comprobación y los archivos de registro de transacciones.

Si la recuperación se ejecuta en un conjunto de registros, para el que no todas las bases de datos están presentes (lo que devolverá el error JET_errAttachedDatabaseMismatch en circunstancias normales) y el cliente desea que la recuperación continúe a pesar de las bases de datos que faltan, se usa el JET_ bitReplayIgnoreMissingDB para continuar la recuperación de las bases de datos disponibles.

Consulte la sección Comentarios de JetInit para obtener más información.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista o Windows XP.
Servidor	Requiere Windows Server 2008 o Windows Server 2003.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.

Consulte también

Archivos extensibles del motor de almacenamiento
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
Parámetros del recurso