View source for SplQueryJob

This function retrieves information about a print job. 
== Syntax == 
 SplQueryJob(pszComputerName, pszQueueName, ulJob, ulLevel, pBuf, cbBuf, pcbNeeded);
== Parameters ==
;pszComputerName (PSZ) - input 
:Name of computer where print job is to be queried. 

:A NULL string specifies the local workstation. 

;pszQueueName (PSZ) - input 
:Queue Name. 

;ulJob (ULONG) - input 
:Job identification number. 

;ulLevel (ULONG) - input 
:Level of detail required. 

:This must be 0, 2, or 3. 

;pBuf (PVOID) - in/out 
:Buffer. 

:The returned contents of the buffer depend on the value specify in ulLevel as follow: 

:ulLevel Buffer Contents 
::0 The job identifier 
::2 A PRJINFO2 structure, with variable information, up to the cbBuf of pBuf 
::3 A PRJINFO3 structure, with variable information, up to the cbBuf of pBuf. 

;cbBuf (ULONG) - input 
:Size, in bytes, of Buffer. 

:It must be greater than 0. 

;pcbNeeded (PULONG) - output 
:Size in bytes of available information. 

== Returns ==
;rc (SPLERR) - returns 
:Return code. 

:;NO_ERROR (0) 
::No errors occurred. 
:;ERROR_ACCESS_DENIED (5) 
::Access is denied. 
:;ERROR_NOT_SUPPORTED (50) 
::This request is not supported by the network. 
:;ERROR_BAD_NETPATH (53) 
::The network path cannot be located. 
:;ERROR_INVALID_PARAMETER (87) 
::An invalid parameter is specified. 
:;ERROR_INVALID_LEVEL (124) 
::The level parameter is invalid. 
:;ERROR_MORE_DATA (234) 
::Additional data is available. 
:;NERR_NetNotStarted (2102) 
::The network program is not started. 
:;NERR_BufTooSmall (2123) 
::The API return buffer is too small. 
:;NERR_JobNotFound (2151) 
::The print job does not exist. 
:;NERR_SpoolerNotLoaded (2161) 
::The spooler is not running. 
:;NERR_InvalidComputer (2351) 
::The computer name is invalid.
== Sample ==
The following sample code will print out the information contained in a PRJINFO3 structure that is returned from a SplQueryJob call. The parameters that are entered on the command line are the computer name, queue name, and the job id. 

<pre>
#define INCL_SPL
#define INCL_SPLDOSPRINT
#define INCL_SPLERRORS
#include <os2.h>
#include <stdio.h>    /* for printf call  */
#include <stdlib.h>   /* for atoi call    */

INT main (argc, argv)
    INT argc;
    CHAR *argv[];
{
    INT       splerr;
    ULONG     cbBuf ;
    ULONG     cbNeeded ;
    ULONG     ulLevel ;
    ULONG     ulJob ;
    PSZ       pszComputerName ;
    PSZ       pszQueueName ;
    PVOID     pBuf;
    PPRJINFO3 pprj3 ;

    /* Input the parameters Computer Name, Queue Name,and Job ID. Check that  */
    /* three parameters have been entered along with the program name.        */
    if (argc != 4)
    {
       /* Print a message and exit if wrong number of parameters entered      */
       printf("Syntax:  sjqry  ComputerName  QueueName  JobID    \n");
       DosExit( EXIT_PROCESS , 0 ) ;
    }
    /* Set the parameters to the values entered on the command line.          */
    pszComputerName = argv[1] ;
    pszQueueName = argv[2] ;
    ulJob = atoi (argv[3]);

    /* Valid levels are 0,2,and 3. Level 3 returns a PRJINFO3 structure.      */
    ulLevel = 3 ;

    /* Call the function with cbBuf equal to zero in order to get the number  */
    /* of bytes needed returned in cbNeeded.                                  */
    splerr = SplQueryJob(pszComputerName,pszQueueName,ulJob,
                            ulLevel, (PVOID)NULL, 0L, &cbNeeded );

    /* Only continue if the error return code is one of the two following.    */
    if (splerr == NERR_BufTooSmall || splerr == ERROR_MORE_DATA )
    {
       /* Allocate memory for the buffer(pBuf). Only continue if memory is    */
       /* successfully allocated.                                             */
       if (DosAllocMem( &pBuf, cbNeeded,
                        PAG_READ|PAG_WRITE|PAG_COMMIT) )
       {
          /* Set the count of bytes needed for the buffer to the value        */
          /* returned in cbNeeded from the first call.                        */
          cbBuf = cbNeeded ;

          /* Make the call again with all the correct values.                 */
          SplQueryJob(pszComputerName,pszQueueName,ulJob,
                               ulLevel, pBuf, cbBuf, &cbNeeded) ;

          /* Set a pointer to point to the beginning of the buffer that holds */
          /* the returned structure.                                          */
          pprj3=(PPRJINFO3)pBuf;

          /* Print out the information for each element in the structure.     */
          printf("Job ID      = %d\n", pprj3->uJobId);
          printf("Job Priority= %d\n", pprj3->uPriority);
          printf("User Name   = %s\n", pprj3->pszUserName);
          printf("Position    = %d\n", pprj3->uPosition);
          printf("Status      = %d\n", pprj3->fsStatus);
          printf("Submitted   = %ld\n",pprj3->ulSubmitted);
          printf("Size        = %ld\n",pprj3->ulSize);
          printf("Comment     = %s\n", pprj3->pszComment);
          printf("Document    = %s\n", pprj3->pszDocument);
          printf("Notify Name = %s\n", pprj3->pszNotifyName);
          printf("Data Type   = %s\n", pprj3->pszDataType);
          printf("Parms       = %s\n", pprj3->pszParms);
          printf("Status      = %s\n", pprj3->pszStatus);
          printf("Queue       = %s\n", pprj3->pszQueue);
          printf("QProc Name  = %s\n", pprj3->pszQProcName);
          printf("QProc Parms = %s\n", pprj3->pszQProcParms);
          printf("Driver Name = %s\n", pprj3->pszDriverName);
          printf("Printer Name= %s\n", pprj3->pszPrinterName);

          /* If pDriverData is NULL, then we can not access any data.         */
          if (pprj3->pDriverData)
          {
             printf("  pDriverData->cb           - %ld\n",
                                    (ULONG)pprj3->pDriverData->cb);
             printf("  pDriverData->lVersion     - %ld\n",
                                    (ULONG)pprj3->pDriverData->lVersion) ;
             printf("  pDriverData->szDeviceName - %s\n",
                                       pprj3->pDriverData->szDeviceName) ;
          }
          printf("/n");

          /* Free memory that we allocated.                                   */
          DosFreeMem(pBuf) ;
       }
    }
    else
    {
       /* If we are here than we have an error code. Print it out.            */
       printf("SplQueryJob Error=%ld,Bytes Needed=%ld\n",splerr, cbNeeded);
    }
    DosExit( EXIT_PROCESS , 0 ) ;
    return(splerr);
}
</pre>

== Call Sequence ==
<pre>
#define INCL_SPL /* Or use INCL_PM, */
#include <os2.h>

PSZ       pszComputerName;  /*  Name of computer where print job is to be queried. */
PSZ       pszQueueName;     /*  Queue Name. */
ULONG     ulJob;            /*  Job identification number. */
ULONG     ulLevel;          /*  Level of detail required. */
PVOID     pBuf;             /*  Buffer. */
ULONG     cbBuf;            /*  Size, in bytes, of Buffer. */
PULONG    pcbNeeded;        /*  Size in bytes of available information. */
SPLERR    rc;               /*  Return code. */

rc = SplQueryJob(pszComputerName, pszQueueName,
       ulJob, ulLevel, pBuf, cbBuf, pcbNeeded);


</pre>

== Related Functions ==
* [[SplEnumJob]]
* [[SplEnumQueue]]
* [[SplQueryQueue]]
* [[SplSetJob]]


[[Category:spl]]