Функция CloseSpoolFileHandle

Функция CloseSpoolFileHandle закрывает дескриптор файла очереди, связанного с заданием печати, которое в настоящее время отправлено приложением.

Синтаксис

BOOL CloseSpoolFileHandle(
  _In_ HANDLE hPrinter,
  _In_ HANDLE hSpoolFile
);

Параметры

hPrinter [in]

Дескриптор принтера, на который было отправлено задание. Это должен быть тот же дескриптор, который использовался для получения hSpoolFile спомощью GetSpoolFileHandle.

hSpoolFile [in]

Дескриптор закрываемого файла очереди. Если CommitSpoolData не был вызван с момента вызова GetSpoolFileHandle , это должен быть тот же дескриптор, который был возвращен Методом GetSpoolFileHandle. В противном случае это должен быть дескриптор, возвращенный последним вызовом CommitSpoolData.

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

ЗНАЧЕНИЕ TRUE, если оно выполнено успешно, в противном случае — FALSE .

Комментарии

Приложение не должно вызывать ClosePrinter в hPrinter , пока оно не будет обращаться к файлу очереди в последний раз. Затем он должен вызвать CloseSpoolFileHandle , а затем ClosePrinter. Попытки получить доступ к дескриптору файла очереди после закрытия исходного hPrinter завершатся ошибкой, даже если сам дескриптор файла не был закрыт. CloseSpoolFileHandle завершится ошибкой , если первым вызывается ClosePrinter .

Требования

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

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

Вывод на печать

Функции API очереди печати принтера

ClosePrinter

GetSpoolFileHandle