Using WHFC with OLE

WHFC is capable as acting as an OLE-automation server. So you can use WHFC e.g. from Correl Office or Word macros and send faxes direct from Correl Office or Word. Some examples how to use the OLE interface can be found on the next page.

If you use functions which uses the windows printer manager and output a file, these functions return, before the entire file is written to disk. In this case you should insert a wait from approximately one second before calling WHFC. But this is a "feature" of the buffer cache algorithm of NT (currently i haven't got an idea for what this feature is useful, but i am in good mood to find a useful application which uses this feature ...)

The OLE interface is called "WHFC.OleSrv". It supports 6 functions :

BSTR GetPhoneBook(Index)

This function retrieves the name of the phonebook with the number Index. If the index is greater than the numbers of the phonebooks GetPhoneBook returns NULL.

You should use this function for getting information about all the phonebooks, WHFC is currently using. Start using this function with Index=0 and count up Index until the function returns NULL.

long SendFax(FileName, FaxNo, RmFile)

This function sends a postscript document to the HylaFAX server and returns the job id if the fax was submitted successfully. When you send to multiple fax addresses it returns the job id of the last transmitted job.

long SendFaxDlg(FileName, RmFile)

This function pops up the faxnumber dialog and asks for the faxnumber. It sends the document to the HylaFAX server and returns the job id if the fax was submitted successfully. When you send to multiple fax addresses it returns the job id of the last transmitted job.

long SendFaxPhoneBook(FileName, FaxNo, PhoneBook, RmFile)

This function works like SendFax, but you can specify a phonebook. If there is an entry in FaxNo wich is not numeric, whfc checks the PhoneBook and tries to resolve the fax number.

BOOL AsyncSendFax(FileName)

This functions submits a document to the HylaFAX server. If this functions is called WHFC pops up the faxnumber dialog and asks for the faxnumbers etc. to submit. AsyncSendFax returns immediately without waiting for submitting the job. The document is removed after submitting the job to the HylaFAX server.

BOOL AsyncSendFaxDocDialog(FileName, DocName)

This functions submits a document with the document name to the HylaFAX server. If this functions is called WHFC pops up the faxnumber dialog including the document name and asks for the faxnumbers etc. to submit. AsyncSendFax returns immediately without waiting for submitting the job. The document is removed after submitting the job to the HylaFAX server.

This functions is used by the fax printer for informing WHFC about new fax jobs.

New OLE Calls in WHFC 1.0.2

BSTR ResolveFaxNo(Alias, PhoneBook,ErrCode )

This function resolves a Faxnumber alias, defined in a phonebook and returns the associated faxnumbers.

LONG GetInfo(Alias, PhoneBook,FaxNo,To,Company,Location,VoiceNo, Remarks,Lpi )

This retrieves all information stored in a phonebook for an alias.

 0 : On Success 
-2 : No valid Faxnumber
-5 : The phonebook specified by
     PhoneBook was not found
-6 : There was a problem on 
     opening the phonebook
-7 : The alias was not found
     in the phonebook