(Page 12 of 15 in this chapter) Version
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.
See Also
- nfxCreateQueue, nfxDestroyQueue, nfxEnqueueDoc
(Page 12 of 15 in this chapter) Version
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights
reserved.