PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
HInfoLock (Function)
In French: HInfoBlocage
HFSQL Client/ServerAvailable only with this kind of connection
Returns information about the lock performed on a data file, on a record or on all the records found in a data file.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 22 and later
Android Widget This function is now available in Android Widget mode.
WINDEVJava This function is now available for the Java applications.
Android This function is now available for the Android applications.
New in version 22
Android Widget This function is now available in Android Widget mode.
WINDEVJava This function is now available for the Java applications.
Android This function is now available for the Android applications.
Android Widget This function is now available in Android Widget mode.
WINDEVJava This function is now available for the Java applications.
Android This function is now available for the Android applications.
Example
LockList is string

// Lists all the locks performed on CUSTOMER file
LockList = HInfoLock(CUSTOMER)

// Lists all the locks performed on the files of CSConnection
LockList = HInfoLock(CSConnection)

// Lists all the locks performed on CUSTOMER.FIC file of CSConnection
LockList = HInfoLock(CSConnection, ".\customer.fic")
Syntax

Information about the locks performed on a file identified by its name Hide the details

<Result> = HInfoLock(<File Name> [, <Record Number>])
<Result>: Character string
  • Empty string ("") if there is no lock or if the data file used is not a HFSQL Client/Server data file.
  • Information about the lock. This information is separated by TAB characters and it has the following format:
    <Physical Name of File Relative to the Database> + TAB +
    <Record Number> + TAB +
    <User> + TAB + <Name of Client Computer> + TAB +
    <IP Address of Client Computer> + TAB + <Name of Client Application> + TAB +
    <Type of lock> + TAB + <Date of lock implementation> + TAB +
    <Number of Seconds since Start of Lock> + CR
    • <Record Number> is set to -1 if the lock was performed on the data file.
    • The <Type of Lock> parameter can correspond to:
      • W: Lock in write mode
      • RW: Lock in read/write
      • W-T: Lock in write mode performed by a transaction
      • RW-T: Lock in read/write performed by a transaction.
    • <Start Date of Lock> has the following format: YYYYMMDDHHMMSS. This date is in UTC format (Universal Time Coordinated).
<File Name>: Character string (with or without quotes)
Name of data file used.
If this parameter corresponds to an empty string (""), HInfoLock handles the last data file used by the last function for HFSQL management (starting with the letter H).
<Record Number>: Optional integer
Number of the record for which the lock information is requested.
If this parameter is not specified, HInfoLock lists all the locks of the data file.

Information about the locks performed on a file identified by its connection Hide the details

<Result> = HInfoLock(<Connection Name> [, <Full Path of File>] [, <Record Number>])
<Result>: Character string
Information about the lock. This information is separated by TAB characters and it has the following format:
<Physical Name of File Relative to the Database> + TAB + <Record Number> +
TAB + <User> + TAB + <Name of Client Computer> + TAB +
<IP Address of Client Computer> + TAB + <Name of Client Application> +
TAB + <Type of Lock> + TAB + <Start Date of Lock> + TAB +
<Nb of Seconds since Start of Lock> + CR
  • <Record Number> is set to -1 if the lock was performed on the data file.
  • The <Type of Lock> parameter can correspond to:
    • W: Lock in write mode
    • W-T: Lock in write mode performed by a transaction
    • RW: Lock in read/write
    • RW-T: Lock in read/write performed by a transaction
  • <Start Date of Lock> has the following format: YYYYMMDDHHMMSS.
<Connection Name>: Character string (with or without quotes)
Name of the connection for which the lock information is requested. This connection was defined in the data model editor, or by HDescribeConnection or HOpenConnection.
If this parameter does not correspond to a connection name, HInfoLock considers that this parameter corresponds to the name of a data file.
<Full Path of File>: Optional character string (with quotes)
Full path of the data file, relative to the database defined by <Connection Name>.
This parameter is ignored if <Connection Name> corresponds to the logical name of a data file.
If this parameter is not specified, all the locks performed on all the data files of the database are returned.
<Record Number>: Optional integer
Number of the record for which the lock information is requested.
If this parameter is not specified, HInfoLock lists all the locks of the data file.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230hf.dll
Windows Mobile wp230hf.dll
Java wd230java.jar
Linux wd230hf.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment