На главную

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

EnumPrinterDrivers



The EnumPrinterDrivers function enumerates all of the printer drivers installed on the specified printer server.

BOOL EnumPrinterDrivers(

LPTSTR pName, // pointer to server name
LPTSTR pEnvironment, // pointer to environment name
DWORD Level, // structure level
LPBYTE pDriverInfo, // pointer to an array of structures
DWORD cbBuf, // size, in bytes, of array
LPDWORD pcbNeeded, // pointer to number of bytes copied (or required)
LPDWORD pcReturned // pointer to number of DRIVER_INFO. structures
);


Parameters

pName

Pointer to a null-terminated string that specifies the name of the server on which the printer drivers should be enumerated.
If pName is NULL, the function enumerates the local machine's printer drivers.

pEnvironment

Pointer to a null-terminated string that specifies the environment. For example, "Windows NT x86" specifies Windows NT running on an Intel 80386 or 80486 processor. If this parameter is NULL, the function uses the current environment of the caller/client (not of the destination/server).

Level

Specifies the type of structures pointed to by pDriverInfo. This value must be 1, 2, or 3.

pDriverInfo

Pointer to a buffer that receives an array of DRIVER_INFO_1, DRIVER_INFO_2, or DRIVER_INFO_3 structures. Each structure contains data that describes an available printer driver.

cbBuf

Specifies the size, in bytes, of the buffer pointed to by pDriverInfo.

pcbNeeded

Pointer to a value that the function sets to the size in bytes of the data that enumerates the printer drivers. If cbBuf is smaller than this value, EnumPrinterDrivers fails, and the variable pointed to by pcbNeeded represents the required buffer size. If cbBuf is equal to or greater than this value, the variable pointed to by pcbNeeded represents the number of bytes stored into the buffer.

pcReturned

Pointer to a value that specifies the number of structures that it stores into the buffer pointed to by pDriverInfo. This is the number of printer drivers installed on the specified print server.



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.

See Also

AddPrinterDriver, DRIVER_INFO_1, DRIVER_INFO_2, DRIVER_INFO_3, GetPrinterDriver


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

EnumPrinterDrivers



Функция EnumPrinterDrivers перечисляет все драйверы принтера установленные в определенном сервере принтера.

BOOL EnumPrinterDrivers(

LPTSTR pName, // УКАЗАТЕЛЬ в имя сервера LPTSTR pEnvironment, // указателя в имя среды DWORD Уровня, // структурного уровня LPBYTE pDriverInfo, // указателя в массив структур DWORD cbBuf, // размера, в байтах, массива LPDWORD pcbNeeded, // указатель в количество байтов скопированных (или требовавшееся) LPDWORD pcReturned // указатель в число структур DRIVER_INFO.
);


Параметры

pName

Указатель в недействительный расторгнутую строку, которая определяет имя сервера на котором драйверы принтера должны быть перечислены.
Если pName НЕДЕЙСТВИТЕЛЕН, функция перечисляет локальные машинные драйверы принтера.

pEnvironment

Указатель в недействительный расторгнутую строку, которая определяет среду. Например, "Windows NT x86" определяет Windows NT, работающее на Intel 80386 или 80486 процессоров. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция использует текущую среду вызывающего оператора/клиента (не расположения/сервера).

Уровень

Определяет тип структур указанных, чтобы pDriverInfo. Эта величина должна быть 1, 2, или 3.

pDriverInfo

Указатель в буфер, который получает массив DRIVER_INFO_1, DRIVER_INFO_2, или структур DRIVER_INFO_3. Каждая структура содержит данные, которые описывают доступный драйвер принтера.

cbBuf

Определяет размер, в байтах, буфера указанного, чтобы pDriverInfo.

pcbNeeded

Указатель в величину, что функция устанавливается в размер в байтах данных, которые перечисляют драйверы принтера. Если cbBuf меньший чем эта величина, EnumPrinterDrivers терпит неудачу, и переменная указанная, чтобы pcbNeeded представляет необходимый буферный размер. Если cbBuf равняется или больше, чем эта величина, переменная указанная, чтобы pcbNeeded представляет количество байтов загруженных в буфер.

pcReturned

Указатель в величину, которая определяет количество структур, что это загружается в буфер указанный, чтобы pDriverInfo. Это - номер драйверов принтера установленного в определенном сервере распечатки.



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

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

Смотри Также

AddPrinterDriver, DRIVER_INFO_1, DRIVER_INFO_2, DRIVER_INFO_3, GetPrinterDriver


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