On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

SetJob

The SetJob function pauses, resumes, cancels, or restarts a print job on a specified printer. You can also use the SetJob function to set print job parameters, such as the print job priority and the document name.

Windows 95: You can use the SetJob function to give a command to a print job, or to set print job parameters, but you can not do both in the same call. Thus, when the Command parameter is non-zero, the function ignores the Level and pJob parameters. To set print job parameters, you must set Command to 0.
Windows NT: You can use the SetJob function to give a command to a print job, or to set print job parameters, or you can do both in the same call. The value of the Command parameter does not affect how the function uses the Level and pJob parameters.

BOOL SetJob(

HANDLE hPrinter, // handle to printer object
DWORD JobId, // print job identifier
DWORD Level, // specifies type of job information structure
LPBYTE pJob, // pointer to job information structure
DWORD Command // job command value
);

Parameters

hPrinter

Handle to the printer object of interest.

JobId

Identifier that specifies the print job. You obtain a print job identifier by calling the AddJob function or the StartDoc function.
Windows NT: If the Level parameter is set to 3, the JobId parameter must match the JobId member of the JOB_INFO_3 structure pointed to by pJob.

Level

Specifies the type of job information structure pointed to by the pJob parameter. You can set the Level parameter to 0, 1, or 2.
When you set Level to 0, pJob should be NULL. Use these values when you are not setting any print job parameters.
Windows NT: You can also set the Level parameter to 3.
Windows 95: The function pays attention to this parameter only if the Command parameter is 0. If Command is non-zero, the function ignores this parameter and the pJob parameter.

pJob

Pointer to a JOB_INFO_1 or JOB_INFO_2 structure. The function uses this structure to set print job parameters.
Windows NT: pJob can also point to a JOB_INFO_3 structure.
If the Level parameter is 0, pJob should be NULL.
If the Level parameter is 1, pJob should point to a JOB_INFO_1 structure. If the Level parameter is 2, pJob should point to a JOB_INFO_2 structure.

Windows NT: If the Level parameter is 3, pJob should point to a JOB_INFO_3 structure. You must have JOB_ACCESS_ADMINISTER access permission for the jobs specified by the JobId and NextJobId members of the JOB_INFO_3 structure.
Windows 95: The function pays attention to this parameter only if the Command parameter is 0. If Command is non-zero, the function ignores this parameter and the Level parameter.

Command

Specifies the print job operation to perform. You can use one of the following values:

Value Meaning
JOB_CONTROL_CANCEL Delete the print job.
JOB_CONTROL_PAUSE Pause the print job.
JOB_CONTROL_RESTART Restart the print job. A job can only be restarted if it was printing.
JOB_CONTROL_RESUME Resume a paused print job.

Windows 95: If you are using the SetJob function to set print job parameters, you must set the Command parameter to 0.
Windows NT: You can use the same call to the SetJob function to set print job parameters and to give a command to a print job. Thus, Command does not need to be 0 if you are setting print job parameters, although it can be.

Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

You can use the SetJob function to set various print job parameters by supplying a pointer to a JOB_INFO_1, JOB_INFO_2, or JOB_INFO_3 structure that contains the necessary data.
Windows 95: When you use the function to set print job parameters, you must set the Command parameter to 0.
To remove or delete all of the print jobs for a particular printer, call the SetPrinter function with its Command parameter set to PRINTER_CONTROL_PURGE.

The following members of a JOB_INFO_1 or JOB_INFO_2 structure are ignored on a call to SetJob:

JobId, pPrinterName, pMachineName, pDrivername, Size, Submitted, and Time.

You must have PRINTER_ACCESS_ADMINISTER access permission for a printer in order to change a print job's position in the print queue.
If you do not want to set a print job's position in the print queue, you should set the Position member of the JOB_INFO_1 or JOB_INFO_2 structure to JOB_POSITION_UNSPECIFIED.
Windows NT: Use the SetJob function with the JOB_INFO_3 structure to link together a set of print jobs. This can be useful in situations where a single document consists of several parts that you want to render separately.

See Also

AddJob, GetJob, OpenPrinter, SetPrinter, JOB_INFO_1, JOB_INFO_2, JOB_INFO_3

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetJob

Функция SetJob останавливается, продолжает, отменяет, или перезапускает работу отпечатка в определенный принтер. Вы можете также использовать функцию SetJob, чтобы устанавливать параметры работы отпечатка, как например, приоритет работы отпечатка и имя документа.

Окно 95: Вы можете использовать функцию SetJob, чтобы давать команду в работу отпечатка, или, чтобы устанавливать параметры работы отпечатка, но Вы не можете делать в том же вызове. Таким образом, когда Командный параметр - не равным нулю, функция игнорирует Уровень и параметры pJob. Чтобы устанавливать параметры работы отпечатка, Вы должны установить Команду на 0.
Окно NT: Вы можете использовать функцию SetJob, чтобы давать команду в работу отпечатка, или, чтобы устанавливать параметры работы отпечатка, или Вы можете делать в том же вызове. Величина Командного параметра не влияет на как функция использует Уровень и параметры pJob.

BOOL SetJob(

РУЧКА hPrinter, // оперируется на объект принтера DWORD JobId, // идентификатор работы Уровня распечатки DWORD, // определяет тип информационной структуры работы LPBYTE pJob, // указателя в работу информационной структурной Команды / DWORD/ командная величина работы
);

Параметры

hPrinter

Прооперируйте объект принтера интереса.

JobId

Идентификатор, который определяет работу распечатки. Вы получаете идентификатор работы распечатки вызывая функцию AddJob или функция StartDoc.
Windows NT: Если параметр Уровня установлен на 3, параметр JobId должен соответствовать элементу JobId структуры JOB_INFO_3 указанной, чтобы pJob.

Уровень

Определяет тип информационной структуры работы указанной, чтобы параметром pJob. Вы можете установить параметр Уровня на 0, 1, или 2.
Когда Вы установили Уровень на 0, pJob должен быть НЕДЕЙСТВИТЕЛЕН. Используйте эти величины когда Вы не устанавливаете любые параметры работы распечатки.
Windows NT: Вы можете также установить параметр Уровня на 3.
Windows 95: функция обращает внимание к этому параметру только если Командный параметр - 0. Если Команда - не равным нулю, функция игнорирует этот параметр и параметр pJob.

pJob

Указатель в JOB_INFO_1 или структуру JOB_INFO_2. Функция использует эту структуру, чтобы устанавливать параметры работы распечатки.
Windows NT: pJob может также указать на структуру JOB_INFO_3.
Если параметр Уровня - 0, pJob должен быть НЕДЕЙСТВИТЕЛЕН.
Если параметр Уровня - 1, pJob должен указывать на структуру JOB_INFO_1. Если параметр Уровня - 2, pJob должен указывать на структуру JOB_INFO_2.

Windows NT: Если параметр Уровня - 3, pJob должен указывать на структуру JOB_INFO_3. Вы должны иметь разрешение доступа JOB_ACCESS_ADMINISTER для рабочих мест определенных JobId и участниками NextJobId структуры JOB_INFO_3.
Windows 95: функция обращает внимание к этому параметру только если Командный параметр - 0. Если Команда - не равным нулю, функция игнорирует этот параметр и параметр Уровня.

Команда

Определяет операцию работы распечатки, чтобы выполняться. Вы можете использовать одно из следующего величин:

Значение Величины
JOB_CONTROL_CANCEL Удаляет работу распечатки.
JOB_CONTROL_PAUSE Останавливается работу распечатки.
JOB_CONTROL_RESTART Перезапускает работу распечатки. Работа может только перезапущена если она печаталась бы.
JOB_CONTROL_RESUME Продолжает остановленную работу распечатки.

Windows 95: Если Вы используете функцию SetJob, чтобы устанавливать параметры работы распечатки, Вы должны установить Командный параметр на 0.
Windows NT: Вы можете использовать тот же вызов в функцию SetJob, чтобы устанавливать параметры работы распечатки и, чтобы давать команду в работу распечатки. Таким образом, Команда не должна быть 0 если Вы устанавливаете параметры работы распечатки, хотя это может быть.

Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Вы можете использовать функцию SetJob, чтобы устанавливать параметры работы различной распечатки поставляя указатель в JOB_INFO_1, JOB_INFO_2, или структуру JOB_INFO_3, которая содержит необходимые данные.
Windows 95: Когда Вы используете функцию, чтобы устанавливать параметры работы распечатки, Вы должны установить Командный параметр на 0.
Для того, чтобы удалять или удалять все рабочие места распечатки для конкретного принтера, назовите функцию SetPrinter со своим Командным параметром установленным на PRINTER_CONTROL_PURGE.

Следующие участники JOB_INFO_1 или структуры JOB_INFO_2 проигнорированы на вызове на SetJob:

JobId, pPrinterName, pMachineName, pDrivername, Size, Поданное, и Время.

Вы должны иметь разрешение доступа PRINTER_ACCESS_ADMINISTER для принтера для того, чтобы изменять позицию работы распечатки в очереди распечатки.
Если Вы не хотите установить позицию работы распечатки в очереди распечатки, Вы должны устанавливать элемент Позиции JOB_INFO_1 или структуры JOB_INFO_2 на JOB_POSITION_UNSPECIFIED.
Windows NT: Используйте функцию SetJob со структурой JOB_INFO_3, чтобы связывать вместе установку рабочих мест распечатки. Это может быть полезным в ситуациях где единственный документ состоит из нескольких частей, которые Вы хотите предоставлять отдельно.

Смотри Также

AddJob, GetJob, OpenPrinter, SetPrinter, JOB_INFO_1, JOB_INFO_2, JOB_INFO_3

Используются технологии uCoz