Función JetIdle
Se aplica a: Windows | Windows Server
Función JetIdle
La función JetIdle está inactiva y solo se debe usar con fines de prueba. JetIdle se puede usar para realizar tareas de limpieza inactivas o comprobar el estado del almacén de versiones en ESE.
JET_ERR JET_API JetIdle(
__in JET_SESID sesid,
__in JET_GRBIT grbit
);
Parámetros
sesid
Sesión que se usará para esta llamada.
grbit
Un grupo de bits que contienen las opciones que se usarán para esta llamada, que incluyen cero o más de los bits siguientes:
Value |
Significado |
|---|---|
JET_bitIdleCompact |
Desencadena la limpieza del almacén de versiones. |
JET_bitIdleFlushBuffers |
Reservado para uso futuro. Si se especifica esta marca, la API devolverá JET_errInvalidgrbit. |
JET_bitIdleStatus |
Devuelve JET_wrnIdleFull si el almacén de versiones está más de medio lleno. |
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.
Código devuelto |
Descripción |
|---|---|
JET_errSuccess |
La operación se ha completado correctamente. |
JET_errInvalidParameter |
Un parámetro grbit que se proporcionó a la API no era válido. |
Si esta función se realiza correctamente, se desencadenará la operación adecuada o se desencadenará un código de error que indica cómo se completa el almacén de versiones en función del grbit proporcionado.
Si se produce un error en esta función, la operación solicitada no se habrá completado correctamente.
Comentarios
El almacén de versiones mantiene el mecanismo de aislamiento de instantáneas de ESE. Si el almacén de versiones es más de medio lleno, el programa podría cerrar las transacciones de larga duración. Si una transacción de larga duración agota el almacén de versiones, ESE dejará de permitir operaciones de escritura en la base de datos.
Requisitos
| Requisito | Value |
|---|---|
Cliente |
Requiere Windows Vista, Windows XP o Windows 2000 Professional. |
Servidor |
Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server. |
Encabezado |
Declarado en Esent.h. |
Library |
Use ESENT.lib. |
Archivo DLL |
Requiere ESENT.dll. |