(Page 5 of 15 in this chapter) Version
nfxCreateQueue
Description
- Creates a queue for either sending or receiving fax documents.
Prototype
- DWORD nfxCreateQueue ( CTAHD ctahd,
int queue_type,
NFX_QUEUE_HANDLE *ptr_queue_handle)
- ctahd Context handle returned by ctaCreateContext.
- queue_type Type of document queue (either NFX_DOC_RECEIVE or NFX_DOC_TRANSMIT).
- ptr_queue_handle Pointer to a location to receive a valid queue handle on a successful return.
Return Values
Events
Details
- The document queue data structure is maintained internally by NaturalFax and a handle is returned to be used with all other NaturalFax functions. Each document queue is associated with a specified context. Subsequent calls to nfxEnqueueDoc, nfxDestroyQueue, nfxSendFax, nfxReceiveFax, or nfxAnswerPoll will verify that the document queue is associated with the same context as the current operation.
- You can associate more than one document queue with a given context, but only one send queue and one receive queue can be associated with an active fax session. For example, to send multiple queues, you must call nfxSendFax for each queue.
See Also
- nfxDestroyQueue
, nfxEnqueueDoc
(Page 5 of 15 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, NMS Communications Corporation. All rights
reserved.