Click above to get retro games delivered to your door ever month!

 QueHaltGet() / QueHaltSet()
------------------------------------------------------------------------------
 Purpose:
 Halt or enable queue servicing.

 Syntax:
 bResult = QueHaltGet( dwQueueID )
 bResult = QueHaltSet( dwQueueID, bHalt )

 Parameters:
 dwQueueID  The print queue ID number.
 bHalt      Specifies whether to halt queue servicing - TRUE to halt
 andFALSE to enable servicing.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 QueHaltGet() is used to determine whether the print queue dwQueueID is
 halted or being serviced. Returns TRUE if the queue is halted, or FALSE
 if the queue is being serviced or if an error occurs.

 QueHaltSet() halts or enables the specified queue dwQueueID. bHalt
 determines whether to halt or enable queue servicing - set to TRUE to halt
 the queue, FALSE to enable servicing of the queue. QueHaltSet() returns the
 previous halt status.

 Example:
 // To determine whether print jobs in the print queue PRINTQ_1
 // are being serviced:
 dwCurrQ = QueIDGet ( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    if QueHaltGet( dwCurrQ )
       ? "Job queue PRINTQ_1 is currently halted"
    endif
 endif
 // To halt print job servicing in the print queue PRINTQ_0:
 dwCurrQ = QueIDGet ( "PRINTQ_0" )
 if ( dwCurrQ != NOVERRLONG )
    if ( QueHalt( CurrQ, TRUE ) )
       ? "Jobs in queue PRINTQ_1 are now halted"
    endif
 endif

 Notes:
 These functions require that the requesting user has queue operator
 rights. The print queue ID number is obtained using the QueIDGet()
 function.

 If FALSE is returned, check NWErrorGet().