Функция ClosePrinter

Статья
06/12/2023

Функция ClosePrinter закрывает указанный объект принтера.

Синтаксис

BOOL ClosePrinter(
  _In_ HANDLE hPrinter
);

Параметры

hPrinter [in]: Дескриптор закрываемого объекта принтера. Этот дескриптор возвращается функцией OpenPrinter или AddPrinter .

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение.

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

При возврате функции ClosePrinter дескриптор hPrinter становится недопустимым независимо от того, выполнена ли функция успешно или неудачно.

Примеры

Пример программы, использующий эту функцию, см. в разделе Практическое руководство. Печать с помощью API печати GDI.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Winspool.h (включая Windows.h)
Библиотека	Winspool.lib
DLL	Spoolss.dll

См. также раздел

Вывод на печать
Функции API очереди печати принтера
AddPrinter
OpenPrinter