ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / Managing faxes
  • WLanguage procedure
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Sends a fax according to the connection that was established beforehand (FaxConnect).
Note: This function can only be used under Windows 2000, XP or higher.. In Windows Vista (and later), the management of faxes is available with Windows Professional and Windows Integral Edition.
Example
IDConnect is int
IDConnect = FaxConnect()
...
ResEnvoiFax is boolean
ResEnvoiFax = FaxSend(IDConnect, "MonFax", "Message.txt", "0102030405")
...
FaxDisconnect(IDConnect)
Syntax
<Result> = FaxSend(<Connection ID> , <Fax name> , <Content file of fax> , <Fax number> [, <Name of cover file> [, <WLanguage procedure>]])
<Result>: Boolean
  • True if the fax was sent,
  • False if an error occurred (in most cases, this error is caused by a configuration problem). To get the details of the error, use ErrorInfo.
<Connection ID>: Integer
Connection identifier, returned by FaxConnect.
<Fax name>: Character string
Name used to identify the outgoing fax. The status of the outgoing fax is returned by FaxStatus.
<Content file of fax>: Character string
Name and path of the file containing the text of the fax (a UNC path can be used). All the types of files that have a "Print" option in their context menu in the explorer can be faxed.
Attention: Depending on the type of file to be faxed, the drivers and applications required to manage this type of file must be installed on the workstation.. For example, to send a PDF file, the drivers required to manage the PDF format must be installed on the computer.
<Fax number>: Character string
Fax number of the recipient. Please note: if a specific designator is required, it must be specified.
<Name of cover file>: Optional character string
Name and path of the file containing the cover page of the fax. This file must use the format of cover pages (.cov). This file can also be created by the fax manager of Windows. For more details, see Sending faxes.
<WLanguage procedure>: Optional procedure name
Name of the WLanguage procedure ("callback") called whenever the status of the outgoing fax changes. This procedure is used to handle the fax.
This procedure has the following format:
PROCEDURE <Nom de la procédure>(<Nom du fax>, <Etat du fax>)

The parameters of this procedure are optional.
There is no need to pass parameters to this procedure. These parameters are automatically filled for each outgoing fax.
Remarks

WLanguage procedure

Each time the status of the fax sent changes, FaxSend automatically calls the <WLanguage procedure>. This procedure is a global or local procedure of WINDEV or WEBDEV.
To create this procedure:
  1. Create a global procedure in the code editor: in the "Code" pane, in the "Procedures" group, pull down "New" and select "New global procedure".
  2. Fill the procedure declaration as follows:
    PROCEDURE <Nom de la procédure> (<Nom du fax>, <Etat du fax>)
    • <Fax name> is the name of the fax used. This name was defined with FaxSend.
    • <Fax status> is one of the constants for fax status (see FaxStatus).
Warning: This procedure must not contain any calls to the debugger (no breakpoint, no STOP keyword, no auto-stop expression, ...).
Component: wd300com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/21/2024

Send a report | Local help