Función JetCloseFile
Se aplica a: Windows | Windows Server
Función JetCloseFile
La función JetCloseFile cierra un archivo que se abrió con JetOpenFile después de extraer los datos de ese archivo mediante JetReadFile.
JET_ERR JET_API JetCloseFile(
__in JET_HANDLE hfFile
);
Parámetros
hfFile
Identificador del archivo que se va a leer.
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_errClientRequestToStopJetService |
No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService. |
JET_errInstanceUnavailable |
No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Windows XP solo devolverá este error y versiones posteriores. |
JET_errInvalidParameter |
Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. Esto puede ocurrir para JetCloseFile cuando:
|
JET_errNoBackup |
Error en la operación porque no hay ninguna copia de seguridad externa en curso. |
JET_errNotInitialized |
No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado. |
JET_errRestoreInProgress |
No es posible completar la operación porque hay una operación de restauración en curso en la instancia asociada a la sesión. |
JET_errRunningInMultiInstanceMode |
Error en la operación porque se intentó usar el motor en modo heredado (modo de compatibilidad de Windows 2000), donde solo se admite una instancia cuando ya existen varias instancias. |
JET_errTermInProgress |
No es posible completar la operación porque se está cerrando la instancia asociada a la sesión. |
Si se ejecuta correctamente, se cierra el identificador de archivo. Si se cerró un archivo de base de datos, se destruye el archivo de revisión de base de datos asociado (si existe).
En caso de error, no se produce ningún cambio.
Comentarios
Actualmente, el motor de base de datos solo admite un archivo abierto a través de JetOpenFile a la vez. Si se abre un identificador de archivo mediante JetOpenFile , debe cerrarse con JetCloseFile antes de que se pueda abrir otro archivo.
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. |
Consulte también
JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService