Метод IPrintCoreUI2::QuerySimulationSupport (prcomoem.h)

Статья
02/07/2025

Метод IPrintCoreUI2::QuerySimulationSupport извлекает структуру возможностей моделирования spooler, которая указывает на типы моделирования, поддерживаемые spooler.

Синтаксис

HRESULT QuerySimulationSupport(
  [in]  HANDLE hPrinter,
  [in]  DWORD  dwLevel,
  [out] PBYTE  pCaps,
  [in]  DWORD  cbSize,
  [out] PDWORD pcbNeeded
);

Параметры

[in] hPrinter

Указывает дескриптор принтера.

[in] dwLevel

Указывает структуру возможностей моделирования spooler, возвращаемую в буфере, на которую указывает pCaps. В настоящее время предоставляется только уровень 1 поддержки моделирования spooler.

Ценность	Структура поддержки моделирования spooler
1	SIMULATE_CAPS_1 (определено в printoem.h)

[out] pCaps

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

[in] cbSize

Указывает размер в байтах выходного буфера, на который указывает pCaps.

[out] pcbNeeded

Указывает размер памяти, необходимой для хранения структуры типа, указанного dwLevel.

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

Метод должен возвращать одно из следующих значений.

Возвращаемый код	Описание
S_OK	Метод выполнен успешно.
E_OUTOFMEMORY	Значение в cbSize было меньше количества байтов, записываемых в выходной буфер (буфер, на который указывает pCaps). Метод был вызван с pCaps значением NULL.
E_NOTIMPL	Метод не поддерживается. Структура типа, указанного dwLevel, не поддерживается.
E_FAIL	Сбой метода

Замечания

Этот метод поддерживается только для подключаемых модулей Windows XP Pscript5, а не для подключаемых модулей Unidrv.

Метод IPrintCoreUI2::QuerySimulationSupport сохраняет структуру возможностей моделирования spooler в буфере, на которую указывает pCaps. Эта структура задает уровень поддержки spooler для печати "N-up", обратной печати, максимальное количество страниц, которые можно печатать, параметры сортировки и т. д.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

См. также

IPrintCoreUI2

SIMULATE_CAPS_1

Поделиться через