PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Special case: Stopping a thread that contains the SocketWairForConnexion function
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
Stops a secondary thread.
The use of this function is not recommended because it violently stops the thread in progress. It may trigger serious problems (incomplete file writing, loss of memory, critical section not freed, ...).
Reminder: A thread is a process run in parallel of current application (main thread). This allows you to run a task in background task for example (backup, ...).
Versions 17 and later
Universal Windows 10 App This function is now available for the Windows Phone applications.
New in version 17
Universal Windows 10 App This function is now available for the Windows Phone applications.
Universal Windows 10 App This function is now available for the Windows Phone applications.
Versions 19 and later
Universal Windows 10 App This function is now available in Windows Store Apps mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
New in version 19
Universal Windows 10 App This function is now available in Windows Store Apps mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Universal Windows 10 App This function is now available in Windows Store Apps mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Versions 21 and later
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Syntax
<Result> = ThreadStop(<Thread Name> [, <Maximum Time-out>])
<Result>: Boolean
  • True if the thread was stopped or if the thread does not exist,
  • False if the thread is locked
<Thread Name>: Character string (with quotes)
Name of thread to stop.
Special cases:
  • If this parameter corresponds to an empty string (""), the current thread is stopped. If the current thread is the main thread, ThreadStop is equivalent to EndProgram.
    Universal Windows 10 App Only this behavior is allowed. ThreadStop cann only be used with the current thread.
  • If the name of the thread does not exist, ThreadStop has no effect and it returns True.
  • If the name of the thread is a child thread or a sibling thread, ThreadStop waits for the current WLanguage function (HReadFirst for example) to end. In this case, ThreadStop is a locking function.
  • If this parameter corresponds to the threadMain constant, the main thread is stopped.
  • Otherwise, a WLanguage error is triggered.
<Maximum Time-out>: Optional integer
Maximum time-out in hundredths of a second.
  • If the thread is not stopped at the end of specified duration, <Result> is set to False.
  • If this parameter is not specified or if it corresponds to the Infinite constant, the wait is infinite.
This parameter can correspond to:
  • an integer corresponding to the number of hundredths of a second,
  • a Duration variable,
  • Versions 23 and later
    the direct indication of duration (1 s or 10 ms for example).
    New in version 23
    the direct indication of duration (1 s or 10 ms for example).
    the direct indication of duration (1 s or 10 ms for example).
Remarks

Special case: Stopping a thread that contains the SocketWairForConnexion function

In order for the thread to be properly stopped by ThreadStop, SocketWaitForConnection must be included in a loop:
Timeout = 30
LOOP
SocketWaitForConnection("MySocket", Duration)
END
Components
WINDEVWEBDEV - Server codeReports and Queries wd230vm.dll
Windows Mobile wp230vm.dll
Java wd230java.jar
Linux wd230vm.so
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment