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 | Скачать

OpenPrinter

The OpenPrinter function retrieves a handle identifying the specified printer or print server.

BOOL OpenPrinter(

LPTSTR pPrinterName, // pointer to printer or server name
LPHANDLE phPrinter, // pointer to printer or server handle
LPPRINTER_DEFAULTS pDefault // pointer to printer defaults structure
);

Parameters

pPrinterName

Points to a null-terminated string that specifies the name of the printer or print server.

phPrinter

Points to a variable that receives the handle identifying the opened printer or print server object.

pDefault

Points to a PRINTER_DEFAULTS structure. This value can be NULL.

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

The pDefault parameter allows an application to specify the data type and device mode values that are used for printing documents submitted by the StartDocPrinter function. However, these values can be overridden by using the SetJob function once a document has been started.
The DesiredAccess member of the PRINTER_DEFAULTS data structure pointed to by pDefault specifies the accesses that an application wishes to perform using the handle returned by OpenPrinter. If an application wishes to open a printer to perform administrative tasks, such as the SetPrinter function, it should open the printer with PRINTER_ALL_ACCESS access. If an application wishes only to perform basic printing operations, an access value that includes PRINTER_ACCESS_USE is sufficient.

Windows 95: OpenPrinter ignores the DesiredAccess member of PRINTER_DEFAULTS.
An application can determine what permissions a client has on a print server, or obtain a handle to a print server to call WaitForPrinterChange. To do so, it should call OpenPrinter with pPrinterName set to the name of the server and should specify a server access mask value such as SERVER_ALL_ACCESS. The pDatatype and pDevMode members of the PRINTER_DEFAULTS data structure should be set to NULL. The handle returned by such a call may be passed to the ClosePrinter or WaitForPrinterChange function.

If a user does not hold permission to open a specified printer or print server with the desired access, the OpenPrinter call will fail, and GetLastError will return the value ERROR_ACCESS_DENIED.

See Also

ClosePrinter, SetPrinter, StartDocPrinter, WaitForPrinterChange, PRINTER_DEFAULTS

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

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

OpenPrinter

Функция OpenPrinter извлекает ручку, опознающую определенный сервер принтера или распечатки.

BOOL OpenPrinter(

LPTSTR pPrinterName, // УКАЗАТЕЛЬ в принтер или имя сервера LPHANDLE phPrinter, // указатель в принтер или ручка сервера LPPRINTER_DEFAULTS pDefault // указатель в принтер устанавливает по умолчанию структуру
);

Параметры

pPrinterName

Точки на недействительный расторгнутую строку, которые определяют имя принтера или печатают сервер.

phPrinter

Точки на переменную, которые получают ручку, опознающую открытый принтер или объект сервера распечатки.

pDefault

Точки на структуру PRINTER_DEFAULTS. Эта величина может быть НЕДЕЙСТВИТЕЛЬНА.

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

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

Замечания

Параметр pDefault позволяет приложение, чтобы определять тип данных и режим устройства оценивает, что использован для печати документов поданных функцией StartDocPrinter. Тем не менее, эти величины могут быть overridden используя функцию SetJob как только документ запущен.
Элемент DesiredAccess структуры данных PRINTER_DEFAULTS указанных, чтобы pDefault определяет доступы, что приложение хочет выполнять используя ручку возвращался OpenPrinter. Если приложение хочет открывать принтер, чтобы выполнять административные задачи, как например, функция SetPrinter, оно должно открывать принтер с доступом PRINTER_ALL_ACCESS. Если приложение хочет, чтобы выполнять основные операции печати, величина доступа, которые включают PRINTER_ACCESS_USE достаточный.

Windows 95: OpenPrinter игнорирует элемент DesiredAccess PRINTER_DEFAULTS.
Приложение может определить какие разрешения, что клиент имеет в сервере распечатки или получает ручку в сервер распечатки, чтобы называть WaitForPrinterChange. Чтобы делать так, это должно называть OpenPrinter с pPrinterName установленное в имя сервера и должно определить величину маски доступа сервера как например, SERVER_ALL_ACCESS. pDatatype И участники pDevMode структуры данных PRINTER_DEFAULTS должны быть установлены на НЕДЕЙСТВИТЕЛЬНЫЙ. Ручка возвращанная таким вызовом может быть пройдена в ClosePrinter или функцию WaitForPrinterChange.

Если пользователь не держит разрешение открывать определенный принтер или печатать сервер с желаемым доступом, вызов OpenPrinter потерпит неудачу, и GetLastError возвращает величину ERROR_ACCESS_DENIED.

Смотри Также

ClosePrinter, SetPrinter, StartDocPrinter, WaitForPrinterChange, PRINTER_DEFAULTS

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