IPrintCoreUI2::QuerySimulationSupport-Methode (prcomoem.h)

Artikel
02/27/2024

Die IPrintCoreUI2::QuerySimulationSupport -Methode ruft eine Spooler-Simulationsfunktionsstruktur ab, die angibt, welche Arten von Simulationen der Spooler unterstützt.

Syntax

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

Parameter

[in] hPrinter

Gibt einen Handle für den Drucker an.

[in] dwLevel

Gibt die Struktur der Spoolersimulationsfunktion an, die im Puffer zurückgegeben wird, auf den pCaps verweist. Derzeit wird nur Unterstützung für Spoolersimulationen der Stufe 1 bereitgestellt.

Wert	Spooler-Simulationsunterstützungsstruktur
1	SIMULATE_CAPS_1 (definiert in printoem.h)

[out] pCaps

Zeiger auf den Ausgabepuffer, der eine Struktur des Typs enthält, die durch den Wert im dwLevel-Parameter angegeben wird.

[in] cbSize

Gibt die Größe des Ausgabepuffers in Bytes an, auf die von pCaps verwiesen wird.

[out] pcbNeeded

Gibt die Größe des Arbeitsspeichers in Bytes an, der zum Speichern einer Struktur des von dwLevel angegebenen Typs benötigt wird.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_OUTOFMEMORY	Der Wert in cbSize war kleiner als die Anzahl der Bytes, die in den Ausgabepuffer geschrieben werden sollen (der Puffer, auf den pCaps verweist). Die Methode wurde aufgerufen, wobei pCaps auf NULL festgelegt ist.
E_NOTIMPL	Die Methode wird nicht unterstützt. Eine Struktur des von dwLevel angegebenen Typs wird nicht unterstützt.
E_FAIL	Fehler bei der Methode

Hinweise

Diese Methode wird nur für Windows XP Pscript5-Plug-Ins und nicht für Unidrv-Plug-Ins unterstützt.

Die IPrintCoreUI2::QuerySimulationSupport Methode speichert eine Spoolersimulationsfunktionsstruktur im Puffer, auf den pCaps verweist. Diese Struktur gibt die Ebene der Spoolerunterstützung für N-Up-Druck, Reversedruck, die maximale Anzahl von Seiten, die gedruckt werden können, Sortierung und andere an.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (einschließlich Prcomoem.h)

Weitere Informationen

IPrintCoreUI2

SIMULATE_CAPS_1