The DosPrintJobSetInfo API changes the instructions for a print job. You also can use it to give a particular print job priority over other print jobs by changing either the position of the job in the printer queue or its priority.
If the spooler is restarted, the order in which jobs are put on the queue depends on the priority and age of the job. This order might be different from the order following the DosPrintJobSetInfo call.
Restrictions
This API can be called from DLS and OS/2 workstations, but DLS workstations can issue this call only to a remote LAN Server workstation.
User authority is allowed limited access to this API. An application that does not have administrator privilege only can move jobs backward in a remote print queue or set a priority lower than the queue priority. In addition, users without administrator privilege can use DosPrintJobSetInfo only for jobs created when the same user name was logged on. A job created locally has no associated user name, and any user can set information locally for the job.
Only an administrator can set information for a job on a remote server.
#define INCL_BASE
#include <os2.h>
#include <pmspl.h>
#include <neterr.h>
#include <netcons.h>
SPLERR SPLENTRY
DosPrintJobSetInfo(pszServername, usJobId, uLevel,
buf, usBuflen, parmnum); /* 16 bit */
Parameters
See Common Parameter Definitions for descriptions of parameters not defined here.
uLevel
Note: The uPosition field of the data structure (pointed
to here with a parmnum value of 6) can be set to any one of the following:
旼컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� VALUE � POSITION CHANGE �
쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 0 � No change �
쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 1 � Moves to first position �
쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� n > 1 � Assumes the nth position in the queue. If n is greater
than �
� � the number of jobs in the queue, the job moves to the end
of �
� � the queue. �
읕컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
The following table lists the return codes most significant to this API.
(See API Return Codes for a complete
list of return codes.) 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커쿞YMBOLICCONSTANT
쿣ALUE쿘EANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_Success � 0 � No errors were encountered. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_ACCESS_DENIED � 5 � Administrator privilege is required. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_BAD_NETPATH � 53 � The network path cannot be found. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_NETWORK_ACCESS_DENIED � 65 � Network access is denied. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_INVALID_PARAMETER � 87 � At least one parameter value is not
�
� � � valid. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_INVALID_LEVEL � 124 � The uLevel parameter is not valid. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_RemoteOnly � 2106 � This operation is not supported on �
� � � workstations. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_BufTooSmall � 2123 � The buffer is too small for fixed- �
� � � length data. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_BadTransactConfig � 2141 � The server is not configured for
�
� � � transactions. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_JobNotFound � 2151 � The print job does not exist. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_SpoolerNotLoaded � 2161 � The spooler service has not been
�
� � � started. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_JobInvalidState � 2164 � This operation cannot be performed
on �
� � � the print job in its current state. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_SpoolNoMemory � 2165 � A spooler memory allocation failure
�
� � � has occurred. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_DriverNotFound � 2166 � The device driver specified has not
�
� � � been installed on the computer. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_DriverNotFound � 2168 � The print processor has not been �
� � � installed on the server. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_InvalidComputer � 2351 � The specified computer name is not
�
� � � valid. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
For information about: