На главную

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 | Скачать Вниз

PRINTER_NOTIFY_INFO_DATA



The PRINTER_NOTIFY_INFO_DATA structure identifies a job or printer information field and provides the current data for that field.

The FindNextPrinterChangeNotification function returns a PRINTER_NOTIFY_INFO structure, which contains an array of PRINTER_NOTIFY_INFO_DATA structures.

typedef struct _PRINTER_NOTIFY_INFO_DATA {
WORD Type;
WORD Field;
DWORD Reserved;
DWORD Id;
union {
DWORD adwData[2];
struct {
DWORD cbBuf;
LPVOID pBuf;
} Data;
} NotifyData;
} PRINTER_NOTIFY_INFO_DATA;


Members

Type

Indicates the type of information provided. This member can be one of the following values:

Value Meaning
PRINTER_NOTIFY_TYPE Indicates that the Field member specifies a PRINTER_NOTIFY_FIELD_* constant.
JOB_NOTIFY_TYPE Indicates that the Field member specifies a JOB_NOTIFY_FIELD_* constant.


Field

Indicates the field that changed. For a list of possible values, see the following Remarks section.

Reserved

Reserved.

Id

Indicates the job identifier if the Type member specifies JOB_NOTIFY_TYPE. If the Type member specfies PRINTER_NOTIFY_TYPE, this member is undefined.

NotifyData

A union of data information based on the Type and Field members. For a description of the type of data associated with each field, see the following Remarks section.
The NotifyData union can be one of the following members:

Member Meaning
adwData An array of two DWORD values. For information fields that use only a single DWORD, the data is in adwData[0]
Data The following members are contained in the Data structure:


Member Meaning
cbBuf Indicates the size, in bytes, of the buffer pointed to by pBuf.
pBuf Points to a buffer that contains the field's current data.


Remarks

If the Type member specifies PRINTER_NOTIFY_TYPE, the Field member can be one of the following values:



Field Type of data
PRINTER_NOTIFY_FIELD_PRINTER_NAME
pBuf points to a null-terminated string containing the name of the printer.
PRINTER_NOTIFY_FIELD_SHARE_NAME
pBuf points to a null-terminated string that identifies the sharepoint for the printer.
PRINTER_NOTIFY_FIELD_DRIVER_NAME
pBuf points to a null-terminated string containing the name of the printer's driver.
PRINTER_NOTIFY_FIELD_COMMENT
pBuf points to a null-terminated string containing the new comment string, which is typically a brief description of the printer.
PRINTER_NOTIFY_FIELD_LOCATION
pBuf points to a null-terminated string containing the new physical location of the printer (for example, "Bldg. 38, Room 1164").
PRINTER_NOTIFY_FIELD_DEVMODE
pBuf points to a DEVMODE structure that defines default printer data such as the paper orientation and the resolution.
PRINTER_NOTIFY_FIELD_SEPFILE
pBuf points to a null-terminated string that specifies the name of the file used to create the separator page. This page is used to separate print jobs sent to the printer.
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR
pBuf points to a null-terminated string that specifies the name of the print processor used by the printer.
PRINTER_NOTIFY_FIELD_PARAMETERS
pBuf points to a null-terminated string that specifies the default print-processor parameters.
PRINTER_NOTIFY_FIELD_DATATYPE
pBuf points to a null-terminated string that specifies the data type used to record the print job.
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR
pBuf points to a SECURITY_DESCRIPTOR structure for the printer. The pointer may be NULL if there is no security descriptor.
PRINTER_NOTIFY_FIELD_ATTRIBUTES
adwData[0] specifies the printer attributes, which can be one of the following values: PRINTER_ATTRIBUTE_QUEUED
PRINTER_ATTRIBUTE_DIRECT
PRINTER_ATTRIBUTE_DEFAULT
PRINTER_ATTRIBUTE_SHARED
PRINTER_NOTIFY_FIELD_PRIORITY
adwData[0] specifies a priority value that the spooler uses to route print jobs.
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY
adwData[0] specifies the default priority value assigned to each print job.
PRINTER_NOTIFY_FIELD_START_TIME
adwData[0] specifies the earliest time at which the printer will print a job. (This value is specified in minutes elapsed since 12:00 A.M.)
PRINTER_NOTIFY_FIELD_UNTIL_TIME
adwData[0] specifies the latest time at which the printer will print a job. (This value is specified in minutes elapsed since 12:00 A.M.)
PRINTER_NOTIFY_FIELD_STATUS
adwData[0] specifies the printer status. For a list of possible values, see the PRINTER_INFO_2 structure.
PRINTER_NOTIFY_FIELD_CJOBS
adwData[0] specifies the number of print jobs that have been queued for the printer.
PRINTER_NOTIFY_FIELD_AVERAGE_PPM
adwData[0] specifies the average number of pages per minute that have been printed on the printer.


If the Type member specifies JOB_NOTIFY_TYPE, the Field member can be one of the following values:



Field Type of data
JOB_NOTIFY_FIELD_PRINTER_NAME
pBuf points to a null-terminated string containing the name of the printer for which the job is spooled.
JOB_NOTIFY_FIELD_MACHINE_NAME
pBuf points to a null-terminated string that specifies the name of the machine that created the print job.
JOB_NOTIFY_FIELD_PORT_NAME
pBuf points to a null-terminated string that identifies the port(s) used to transmit data to the printer. If a printer is connected to more than one port, the names of the ports are separated by commas (for example, "LPT1:,LPT2:,LPT3:").
JOB_NOTIFY_FIELD_USER_NAME
pBuf points to a null-terminated string that specifies the name of the user who sent the print job.
JOB_NOTIFY_FIELD_NOTIFY_NAME
pBuf points to a null-terminated string that specifies the name of the user who should be notified when the job has been printed or when an error occurs while printing the job.
JOB_NOTIFY_FIELD_DATATYPE
pBuf points to a null-terminated string that specifies the type of data used to record the print job.
JOB_NOTIFY_FIELD_PRINT_PROCESSOR
pBuf points to a null-terminated string that specifies the name of the print processor to be used to print the job.
JOB_NOTIFY_FIELD_PARAMETERS
pBuf points to a null-terminated string that specifies print-processor parameters.
JOB_NOTIFY_FIELD_DRIVER_NAME
pBuf points to a null-terminated string that specifies the name of the printer driver that should be used to process the print job.
JOB_NOTIFY_FIELD_DEVMODE
pBuf points to a DEVMODE structure that contains device-initialization and environment data for the printer driver.
JOB_NOTIFY_FIELD_STATUS
adwData[0] specifies the job status. For a list of possible values, see the JOB_INFO_2 structure.
JOB_NOTIFY_FIELD_STATUS_STRING
pBuf points to a null-terminated string that specifies the status of the print job.
JOB_NOTIFY_FIELD_DOCUMENT
pBuf points to a null-terminated string that specifies the name of the print job (for example, "MS-WORD: Review.doc").
JOB_NOTIFY_FIELD_PRIORITY
adwData[0] specifies the job priority.
JOB_NOTIFY_FIELD_POSITION
adwData[0] specifies the job's position in the print queue.
JOB_NOTIFY_FIELD_SUBMITTED
pBuf points to a SYSTEMTIME structure that specifies the time when the job was submitted.
JOB_NOTIFY_FIELD_START_TIME
adwData[0] specifies the earliest time that the job can be printed. (This value is specified in minutes elapsed since 12:00 A.M.)
JOB_NOTIFY_FIELD_UNTIL_TIME
adwData[0] specifies the the latest time that the job can be printed. (This value is specified in minutes elapsed since 12:00 A.M.)
JOB_NOTIFY_FIELD_TIME
adwData[0] specifies the total time, in seconds, that has elapsed since the job began printing.
JOB_NOTIFY_FIELD_TOTAL_PAGES
adwData[0] specifies the size, in pages, of the job.
JOB_NOTIFY_FIELD_PAGES_PRINTED
adwData[0] specifies the number of pages that have printed.
JOB_NOTIFY_FIELD_TOTAL_BYTES
adwData[0] specifies the size, in bytes, of the job.
JOB_NOTIFY_FIELD_BYTES_PRINTED
adwData[0] specifies the number of bytes that have been printed on this job. For this field, the change notification object is signaled when bytes are sent to the printer.


See Also

DEVMODE, FindNextPrinterChangeNotification, JOB_INFO_2, PRINTER_INFO_2, PRINTER_NOTIFY_INFO, SECURITY_DESCRIPTOR, SYSTEMTIME


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

PRINTER_NOTIFY_INFO_DATA



Структура PRINTER_NOTIFY_INFO_DATA идентифицирует работу или информационную область принтера и обеспечивает текущие данные для этой области.

Функция FindNextPrinterChangeNotification возвращает структуру PRINTER_NOTIFY_INFO, которая содержит массив структур PRINTER_NOTIFY_INFO_DATA.

typedef struct _PRINTER_NOTIFY_INFO_DATA { WORD Type;
WORD Field;
DWORD ЗАРЕЗЕРВИРОВАН;
DWORD Id;
союз {
DWORD adwData[2];
struct { DWORD cbBuf;
LPVOID pBuf;
} Данные;
} NotifyData;
} PRINTER_NOTIFY_INFO_DATA;


Участники

Тип

Указывает тип предусмотренной информации. Этот элемент может быть одним из следующего величин:

Значение Величины
PRINTER_NOTIFY_TYPE Указывает, что элемент Области определяет PRINTER_NOTIFY_FIELD_* константа.
JOB_NOTIFY_TYPE Указывает, что элемент Области определяет JOB_NOTIFY_FIELD_* константа.


Область

Указывает область, что изменялся. Для списка возможных величин, смотри секцию Замечаний следующего.

Зарезервированное

Зарезервированное.

Id

Указывает идентификатор работы если элемент Типа определяет JOB_NOTIFY_TYPE. Если элемент Типа specfies PRINTER_NOTIFY_TYPE, этот элемент неопределенное.

NotifyData

Союз информации данных основывался на участниках Типа и Области. Для описания типа данных связанных каждой областью, смотри секцию Замечаний следующего.
Союз NotifyData может быть одним из следующих участников:

Значение Элемента
adwData Массив двух величин DWORD. Для информационных областей, которые используют только единственный DWORD, данные - в adwData[0] Данных следующие участники содержались в структуре Данных:


Значение Элемента
cbBuf Указывает размер, в байтах, буфера указанного, чтобы pBuf.
pBuf Указывает на буфер, который содержит текущие данные области.


Замечания

Если элемент Типа определяет PRINTER_NOTIFY_TYPE, элемент Области может быть одним из следующего величин:



Тип Области данных PRINTER_NOTIFY_FIELD_PRINTER_NAME
pBuf Указывает на недействительный расторгнутую строку, содержащую имя принтера.
PRINTER_NOTIFY_FIELD_SHARE_NAME
pBuf Указывает на недействительный расторгнутую строку, которая идентифицирует sharepoint для принтера.
PRINTER_NOTIFY_FIELD_DRIVER_NAME
pBuf Указывает на недействительный расторгнутую строку, содержащую имя драйвера принтера.
PRINTER_NOTIFY_FIELD_COMMENT
pBuf Указывает на недействительный расторгнутую строку, содержащую новую строку комментария, которая - обычно краткое описание принтера.
PRINTER_NOTIFY_FIELD_LOCATION
pBuf Указывает на недействительный расторгнутую строку, содержащую новую физическую позицию принтера (например, "Bldg. 38, Комната 1164").
PRINTER_NOTIFY_FIELD_DEVMODE
pBuf Указывает на структуру DEVMODE, которая определяет по умолчанию данные принтера как например, бумажная ориентация и разрешение.
PRINTER_NOTIFY_FIELD_SEPFILE
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя файла использованное, чтобы создавать страницу разделителя. Эта страница использована, чтобы разделять рабочие места распечатки посылался в принтер.
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя процессора распечатки использовался принтером.
PRINTER_NOTIFY_FIELD_PARAMETERS
pBuf Указывает на недействительный расторгнутую строку, которая определяет по умолчанию распечатку-процессор параметров.
PRINTER_NOTIFY_FIELD_DATATYPE
pBuf Указывает на недействительный расторгнутую строку, которая определяет тип данных использованное, чтобы записывать работу распечатки.
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR
pBuf Указывает на структуру SECURITY_DESCRIPTOR для принтера. Указатель может быть НЕДЕЙСТВИТЕЛЕН если нет дескриптора безопасности.
PRINTER_NOTIFY_FIELD_ATTRIBUTES
adwData[0] Определяет атрибуты принтера, которые могут быть одно из следующего величин: PRINTER_ATTRIBUTE_QUEUED PRINTER_ATTRIBUTE_DIRECT PRINTER_ATTRIBUTE_DEFAULT PRINTER_ATTRIBUTE_SHARED PRINTER_NOTIFY_FIELD_PRIORITY
adwData[0] Определяет приоритетную величину, что spooler использует, чтобы направлять рабочие места распечатки.
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY adwData[0] определяет по умолчанию приоритетную величину назначенную в каждую работу распечатки.
PRINTER_NOTIFY_FIELD_START_TIME
adwData[0] Определяет самое раннее время в котором принтер напечатает работу. (Эта величина определена в минутах пройденных с 12:00 ДО ПОЛУДНЯ) PRINTER_NOTIFY_FIELD_UNTIL_TIME adwData[0] определяет самое последнее время в котором принтер напечатает работу. (Эта величина определена в минутах пройденных с 12:00 ДО ПОЛУДНЯ) PRINTER_NOTIFY_FIELD_STATUS adwData[0] определяет статус принтера. Для списка возможных величин, смотри структуру PRINTER_INFO_2.
PRINTER_NOTIFY_FIELD_CJOBS
adwData[0] Определяет номер рабочих мест распечатки, которая поставлена в очередь для принтера.
PRINTER_NOTIFY_FIELD_AVERAGE_PPM
adwData[0] Определяет среднее количество страниц за минуту, которая напечатана в принтере.


Если элемент Типа определяет JOB_NOTIFY_TYPE, элемент Области может быть одним из следующего величин:



Тип Области данных JOB_NOTIFY_FIELD_PRINTER_NAME
pBuf Указывает на недействительный расторгнутую строку, содержащую имя принтера для которого работа буферизована.
JOB_NOTIFY_FIELD_MACHINE_NAME
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя машины, которая создавала работу распечатки.
JOB_NOTIFY_FIELD_PORT_NAME
pBuf Указывает на недействительный расторгнутую строку, которая идентифицирует порт(s) использованное, чтобы передавать данные на принтер. Если принтер подключен к более, чем один порт, имена портов разделены запятыми (например, "LPT1:,LPT2:,LPT3:").
JOB_NOTIFY_FIELD_USER_NAME
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя пользователя, который посылал распечатке работу.
JOB_NOTIFY_FIELD_NOTIFY_NAME
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя пользователя, который должен быть извещен когда работа напечатана или когда ошибка происходит при печати работы.
JOB_NOTIFY_FIELD_DATATYPE
pBuf Указывает на недействительный расторгнутую строку, которая определяет тип данных использованное, чтобы записывать работу распечатки.
JOB_NOTIFY_FIELD_PRINT_PROCESSOR
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя процессора распечатки, которая нужно использоваться, чтобы печатать работу.
JOB_NOTIFY_FIELD_PARAMETERS
pBuf Указывает на недействительный расторгнутую строку, которая определяет распечатку-процессор параметров.
JOB_NOTIFY_FIELD_DRIVER_NAME
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя драйвера принтера, который должен быть использован, чтобы обрабатывать работу распечатки.
JOB_NOTIFY_FIELD_DEVMODE
pBuf Указывает на структуру DEVMODE, которая содержит устройство-инициализацию и данные среды для драйвера принтера.
JOB_NOTIFY_FIELD_STATUS
adwData[0] Определяет статус работы. Для списка возможных величин, смотри структуру JOB_INFO_2.
JOB_NOTIFY_FIELD_STATUS_STRING
pBuf Указывает на недействительный расторгнутую строку, которая определяет статус работы распечатки.
JOB_NOTIFY_FIELD_DOCUMENT
pBuf Указывает на недействительный расторгнутую строку, которая определяет имя работы распечатки (например, "МС-WORD: Review.doc").
JOB_NOTIFY_FIELD_PRIORITY adwData[0] определяет приоритет работы.
JOB_NOTIFY_FIELD_POSITION
adwData[0] Определяет позицию работы в очереди распечатки.
JOB_NOTIFY_FIELD_SUBMITTED
pBuf Указывает на структуру SYSTEMTIME, которая определяет время когда работа была подана.
JOB_NOTIFY_FIELD_START_TIME
adwData[0] Определяет самое раннее время, что работа может быть напечатана. (Эта величина определена в минутах пройденных с 12:00 ДО ПОЛУДНЯ) JOB_NOTIFY_FIELD_UNTIL_TIME adwData[0] определяет самое последнее время, что работа может быть напечатана. (Эта величина определена в минутах пройденных с 12:00 ДО ПОЛУДНЯ) JOB_NOTIFY_FIELD_TIME adwData[0] определяет полное время, в течение секунд, которое прошло с тех пор как тех пор как работа начала печатаются.
JOB_NOTIFY_FIELD_TOTAL_PAGES adwData[0] определяет размер, на страницах, работы.
JOB_NOTIFY_FIELD_PAGES_PRINTED adwData[0] определяет количество страниц, которые напечатались.
JOB_NOTIFY_FIELD_TOTAL_BYTES adwData[0] определяет размер, в байтах, работы.
JOB_NOTIFY_FIELD_BYTES_PRINTED
adwData[0] Определяет количество байтов, которые напечатаны в этой работе. Для этой области, объект уведомления изменения сигнализирован когда байты посланы в принтер.


Смотри Также

DEVMODE, FindNextPrinterChangeNotification, JOB_INFO_2, PRINTER_INFO_2, PRINTER_NOTIFY_INFO, SECURITY_DESCRIPTOR, SYSTEMTIME


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz