IPrintCoreHelper::GetOption-Methode (prcomoem.h)

Artikel
02/26/2024

Die IPrintCoreHelper::GetOption-Methode ruft eine angegebene Option für ein bestimmtes Feature ab.

Syntax

HRESULT GetOption(
  [in]  const DEVMODE *pDevmode,
  [in]  DWORD         cbSize,
  [in]  PCSTR         pszFeatureRequested,
  [out] PCSTR         *ppszOption
);

Parameter

[in] pDevmode

Ein Zeiger auf eine DEVMODEW-Struktur . Wenn dieser Zeiger bereitgestellt wird, sollte IPrintCoreHelper::GetOption die DEVMODEW-Struktur verwenden, auf die von pDevmode anstelle der standardmäßigen oder aktuellen DEVMODEW-Struktur verwiesen wird. Wenn diese Methode vom Plug-In-Anbieter oder von IPrintOemPS::D evMode oder IPrintOemUni::D evMode aufgerufen wird, ist dieser Parameter erforderlich. In den meisten anderen Situationen sollte der Parameter NULL sein. Wenn der Kerntreiber pDevmode auf NULL festlegt, ändert er seinen internen Zustand anstelle der übergebenen DEVMODEW-Struktur. Dies ist bei Vorgängen wie dem vollständigen Austausch der Benutzeroberfläche erforderlich, bei denen die von einem DDI zurückgegebene DEVMODEW-Struktur, z. B . DrvDocumentPropertySheets, vom Benutzeroberflächenmodul des Kerntreibers gewartet wird.

[in] cbSize

Die Größe der DEVMODEW-Struktur in Bytes, auf die der pDevmode-Parameter verweist.

[in] pszFeatureRequested

Ein Zeiger auf die ANSI-Zeichenfolge, die den Namen des Features enthält, wie er in der GPD-Datei angezeigt wird.

[out] ppszOption

Ein Zeiger auf eine Variable, die die Adresse einer ANSI-Zeichenfolge enthält. Wenn IPrintCoreHelper::GetOption zurückgibt, sollte die Zeichenfolge die Schlüsselwort (keyword) für die aktuell ausgewählte Option enthalten, wie sie in der Konfigurationsdatei angezeigt wird. Der Aufrufer sollte diese Zeichenfolge nicht ändern und den Speicher, der dieser Zeichenfolge zugeordnet ist, nicht freigeben.

Rückgabewert

IPrintCoreHelper::GetOption sollte einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die -Methode liest die Option für das angegebene Feature.
E_FAIL	Der Aufrufer gab Informationen an, die zu einer ungültigen Anforderung geführt haben. Beispielsweise ist das angeforderte Feature nicht vorhanden.
E_INVALIDARG	Die Argumente waren ungültig. Dieser Wert kann bedeuten, dass das Feature nicht unterstützt wird oder dass zu viele Optionen für das Feature angefordert wurden.
E_OUTOFMEMORY	Der Kerntreiber konnte die Anforderung nicht verarbeiten, da nicht genügend Arbeitsspeicher vorhanden war.
E_UNEXPECTED oder andere Rückgabecodes, die hier nicht aufgeführt sind	Der Kerntreiber scheint sich in einem ungültigen Zustand zu befinden. Der Aufrufer sollte einen Fehlercode zurückgeben.

Hinweise

IPrintCoreHelper::GetOption kann nicht für Features verwendet werden, mit denen mehrere Optionen gleichzeitig festgelegt werden können.

Featureschlüsselwörter sind in den GPD- und PPD-Dateien definiert. Darüber hinaus unterstützen die Unidrv- und Pscript5-Treiber mehrere reservierte Schlüsselwörter für Optionen, die in ihren privaten DEVMODEW-Strukturen gespeichert werden.

Der Aufrufer sollte die Zeichenfolge, auf die von ppszOption verwiesen wird, nicht freigeben und die Zeichenfolge in keiner Weise ändern.