|
|
|
|
- Modificar el tipo de bloqueo en un archivo de datos
- Efecto del modo de bloqueo
- Error de bloqueo
HLockFile (Función)
No disponible con estos tipos de conexión
Bloquea un archivo de datos e impide que los demás sitios o aplicaciones accedan a él. El archivo de datos podrá desbloquearse con la función HUnlockFile. Después de llamar a la función HLockFile, se pueden producir varios errores: - Un registro del archivo de datos ya está bloqueado por otra aplicación: no se puede realizar el bloqueo.
- El archivo de datos ya está bloqueado por otra aplicación: no se puede realizar el bloqueo.
La función HErrorLock devuelve True si se produce un problema de bloqueo. // Lock the CUSTOMER data file IF HLockFile(CUSTOMER, hLockReadWrite) = False THEN IF HErrorLock() = True THEN Error("Operation not allowed") END END // Process on data file ... ... // Restore access to data file HUnlockFile()
Sintaxis
<Result> = HLockFile([<Data file> [, <Lock>]])
<Result>: Boolean - True si se realizó el bloqueo,
- False si se produce un problema (por ejemplo, si el archivo ya está bloqueado, etc.). La función HError permite identificar el error.
<Data file>: Cadena de caracteres opcional (con o sin comillas) Nombre del archivo de datos utilizado. Si no se especifica este nombre, HLockFile utilizará el último archivo de datos utilizado por la última función de gestión de HFSQL (función que comienza con "H"). <Lock>: Constante opcional de tipo Integer Permite definir el tipo de bloqueo que se realiza en el archivo de datos:
| | hLockWrite (valor predeterminado) | Bloqueo de escritura: otras aplicaciones pueden leer los registros pero no modificarlos. Ninguna otra aplicación puede definir un bloqueo en el archivo de datos. | hLockReadWrite | Bloqueo de lectura/escritura: otras aplicaciones no pueden leer ni modificar los registros del archivo de datos. Ninguna otra aplicación puede definir un bloqueo en el archivo de datos. | hLockNo | Ningún efecto |
Observaciones Modificar el tipo de bloqueo en un archivo de datos Para modificar el tipo de bloqueo de un archivo de datos, llame a la función HLockFile con el tipo de bloqueo deseado. No es necesario desbloquear el archivo de datos. Efecto del modo de bloqueo Si el archivo de datos está en modo de bloqueo hModeMono (ver función HMode), la función HLockFile no tiene ningún efecto. Error de bloqueo Si el archivo de datos (o uno de sus registros) ya está bloqueado, la solicitud de bloqueo se repite H.NbRetry veces (50 por defecto). Si el archivo de datos no puede bloquearse tras los intentos de H.NbRetry, HErrorLock devuelve True.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|