(Page 1 of 1 in this chapter)

Chapter 5

Using NaturalFax for TAPI Functions

: 5.1 Introduction

5.1 Introduction

The NaturalFax for TAPI API enables applications to send and receive faxes using NMS hardware. See the NaturalFax for TAPI Developer's Reference Manual for detailed information needed to add fax to a TAPI application.
These are the fax functions supported by NMS TAPI:

NaturalFax for TAPI Functions

Description

faxAnswerFaxPoll

Provides a queue of documents to send in response to a poll request from the remote sending fax terminal.

faxClose

Closes the devices and invalidates associated handle.

faxCreateQueue

Creates a queue for either sending or receiving documents.

faxDestroyQueue

Deletes the specified document queue.

faxEnqueueDoc

Adds a document to a document queue.

faxGetDocStatus

Returns status of a document in the specified queue.

faxGetID

Supplies a fax device ID.

faxGetMessage

Handles events using a Win32 event object.

faxGetSessionStatus

Returns status information during a fax send or receive operation.

faxOpen

Accepts a device ID, verifies the device, and creates and stores an associated handle.

faxReceiveDocument

For handling single documents, creates and destroys a queue, places a document into the queue and receives it.

faxReceiveFax

Starts negotiating as the called fax terminal and then places all received documents into the receive queue.

faxResetQueue

Resets all documents in a queue to unsent.

faxSendDocument

For handling single documents, creates and destroys a queue, places a document into the queue and sends it.

faxSendFax

Starts negotiating with the remote fax receiver and subsequently sends all the documents in the send queue.

faxStopSession

Stops a fax send or receive operation in progress.

NaturalFax for TAPI Functions	Description
faxAnswerFaxPoll	Provides a queue of documents to send in response to a poll request from the remote sending fax terminal.
faxClose	Closes the devices and invalidates associated handle.
faxCreateQueue	Creates a queue for either sending or receiving documents.
faxDestroyQueue	Deletes the specified document queue.
faxEnqueueDoc	Adds a document to a document queue.
faxGetDocStatus	Returns status of a document in the specified queue.
faxGetID	Supplies a fax device ID.
faxGetMessage	Handles events using a Win32 event object.
faxGetSessionStatus	Returns status information during a fax send or receive operation.
faxOpen	Accepts a device ID, verifies the device, and creates and stores an associated handle.
faxReceiveDocument	For handling single documents, creates and destroys a queue, places a document into the queue and receives it.
faxReceiveFax	Starts negotiating as the called fax terminal and then places all received documents into the receive queue.
faxResetQueue	Resets all documents in a queue to unsent.
faxSendDocument	For handling single documents, creates and destroys a queue, places a document into the queue and sends it.
faxSendFax	Starts negotiating with the remote fax receiver and subsequently sends all the documents in the send queue.
faxStopSession	Stops a fax send or receive operation in progress.

(Page 1 of 1 in this chapter)

tech_support@nmss.com