(Page 15 of 18 in this chapter)
nfxResetQueue
Description
- Resets all the flags in a queue to mark all documents as unsent.
Prototype
- DWORD nfxResetQueue ( CTAHD ctahd,
NFX_QUEUE_HANDLE queue_handle)
- ctahd CTA context handle returned by ctaCreateContext.
- queue_handle Identifies which queue to reset.
Return Values
Events
Details
- Each document in a queue is flagged as "sent" when it is successfully sent. If a problem occurs during transmission, the whole queue may be resubmitted and only unflagged documents will be sent.
- Calling nfxResetQueue resets all flags so that all documents in the specified queue can be resent. This function is typically used in broadcast applications, which send the same queue of documents on multiple phone calls.
- If this function is called with a receive queue, it also changes the queue type to a transmit queue. This use is typical of a fax store-and-forward application.
- This function does not require allocation of a fax license unit.
See Also
- nfxCreateQueue, nfxDestroyQueue, nfxEnqueueDoc
(Page 15 of 18 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.