MS Windows Client OCX

The installation of the MS Windows Client also installs the Fax2Send OCX. Developers using tools such as Visual Basic and Visual C++ can use the OCX to integrate Fax2Send with their applications.

Please note that users with Versions 2.1-5 or earlier of the client will need to register the ocx by hand.

• BSTR LoginName - Login name of user - read only
• BSTR JobName - Free format job name for request in queue
• long LockFileTimeOut - Time in MILLISECONDS
• long PrintFileTimeOut - Time in SECONDS
• BSTR FaxNumber - Fax phone number
• boolean HighResolution - TRUE for 200X200dpi, FALSE for 200X100dpi
• BSTR SendTime - Format of HHMM or "" for Now!
• BSTR strError - Strings containing error text.
• long nError - OCX Error number
• long nDLLError - Fax2Send DLL error number.

Use Set and Get e.g GetJobName() and SetJobName("My Job name").

• boolean StartJob()
• boolean EndJob()
• boolean Login()
• boolean Logout()
• boolean ClearLockFile()

1. Call Login method.
2. Set LockFileTimeOut and PrintFileTimeOut properties if desired.
3. For each fax to be sent:
   1. Set FaxNumber, JobName, HighResolution and SendTime properties.
   2. Call StartJob method.
   3. Print to the FAX2SEND printer.
   4. Call EndJob.
4. Call Logout method.

• JobName = ""
• LockFileTimeOut = 1000
• PrintFileTimeOut = 30
• FaxNumber = ""
• HighResolution = TRUE
• SendTime = ""
• strError = ""
• nError = 0
• nDLLError = 0

The values of Properties are not reset between Jobs.

0. Success
1. Job Not Started
2. DLL Error (see DLL Error Code Value)
3. Lock File Exists
4. Cannot access lock file
5. Too many open files
6. Permission denied on removing printer file
7. Failed to close lock file
8. Permission denied on removing lock file
9. Lock file does not exist
10. No fax number
11. Not logged in

0. Success
1. User not logged in
2. Only one login per process please
3. Out of memory
4. Specified file not found
5. Timeout
6. Fax2Send not installed properly
7. Winsock not available
8. Winsock wrong version or bad exe
9. Config bad or missing
10. HP LaserJet III printer driver not installed
11. Some system error
12. Connection refused
13. Command not recognised by server
14. Reserved
15. Permission denied
16. Network error
17. Winsock error
18. No faxdaemon found on server
19. General ufax error
20. No file association for shellexec
21. Error with file access, write, move etc
22. Shell exec error
23. Connection closed by remote
24. No more data
25. Attempt to change printer config when in use
26. Illegal status mode
27. Error code on fax2stat command
28. Not yet implemented
29. Action already done, ignoring
30. Invalid user
31. Admin not available at this time
32. No ddeml or ddeml failure
33. No ddeml connection available for server, topic pair
34. ddeml is busy, should try later
35. ddeml command not processed by server
36. some ddeml error
37. ddeml server is not taking
38. Express fax permission denied
39. Reserved
40. Remote file access error
41. Queue currently inaccessible
42. Remote file access reading mailshot file
43. Remote mailshot file bad / corrupt
44. Invalid phone number
45. Banned phone number tried
46. Cannot access list of express users
47. Remote system error
48. fax2 command too long (use less text, or less files)
49. Local license key is invalid
50. Reserved
51. No header file specified with -H flag to fax command
52. Invalid time format with -t flag
53. One of the files in the request is empty

• On Windows 98 and ME the command is:
  
  C:\Windows\System\Regsvr32.exe c:\Windows\System\Fax2Send.ocx
  
• On Windows NT4 and 2000:
  
  C:\Winnt\System32\Regsvr32.exe c:\Winnt\System32\Fax2Send.ocx