# nfxDestroyQueue

Deletes the specified document queue and frees the corresponding queue handle.

#### Prototype

DWORD nfxDestroyQueue ( CTAHD ctahd, NFX_QUEUE_HANDLE queue_handle)

Argument | Description
ctahd | Context handle returned by ctaCreateContext.
queue_handle | Identifies the queue to be freed.

#### Return values

Return value | Description
SUCCESS |
CTAERR_BAD_ARGUMENT | Invalid function argument passed.
CTAERR_INVALID_CTAHD | The specified context handle is invalid.
CTAERR_INVALID_HANDLE | The specified document queue handle is invalid.

#### Events

None.

#### Details

This function deallocates the structures that maintain a document queue and deletes any remaining document entries in the designated document queue. After the application invokes nfxDestroyQueue, the specified queue handle is no longer valid for subsequent calls. The files identified by the queue structures are untouched.

The queue structure is deallocated also when ctaCloseServices is called.

Refer to Terminating and shutting down for more information.

#### See also

nfxCreateQueue, nfxEnqueueDoc