IPrintOemUI::GetInfo-Methode (prcomoem.h)

Die Methode eines Benutzeroberflächen-Plug-Ins gibt Identifikationsinformationen IPrintOemUI::GetInfo zurück.

Syntax

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Parameter

dwMode

Enthält eine der folgenden vom Aufrufer bereitgestellten ganzzahligen Konstanten.

OEMGI_GETREQUESTEDHELPERINTERFACES

Die Methode muss den Bitflagwert von OEMPUBLISH_IPRINTCOREHELPER in den Puffer pBuffer schreiben, wenn die IPrintOemUI::P ublishDriverInterface-Methode mit dem Parameter pIUnknown aufgerufen werden soll, der auf ein Objekt verweist, das die IPrintCoreHelperPS-Schnittstelle oder IPrintCoreHelperUni-Schnittstelle implementiert.

OEMGI_GETSIGNATURE

Die Methode muss eine eindeutige Vier-Byte-Identifikationssignatur zurückgeben. Das Plug-In muss diese Signatur auch in OPTITEM-Strukturen platzieren, wie in der Beschreibung des pOEMOptItems-Members der OEMCUIPPARAM-Struktur beschrieben.

OEMGI_GETVERSION

Die Methode muss die Versionsnummer des Benutzeroberflächen-Plug-Ins als DWORD zurückgeben. Das Versionsformat ist vom Entwickler definiert.

pBuffer

Vom Aufrufer bereitgestellter Zeiger auf den Speicher, der für den Empfang der von dwMode angegebenen Informationen zugewiesen ist.

cbSize

Vom Aufrufer bereitgestellte Größe des Puffers, auf den pBuffer verweist.

pcbNeeded

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, an dem die Anzahl von Bytes empfangen werden soll, die in den Puffer geschrieben wurden, auf den pBuffer verweist.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

Benutzeroberflächen-Plug-Ins sind erforderlich, um die IPrintOemUI::GetInfo Methode zu implementieren, die unmittelbar nach dem Laden des Plug-Ins aufgerufen wird. Die Methode sollte die angegebenen Informationen zurückgeben, indem sie sie an die von pBuffer angegebene Adresse schreibt und die Größe der zurückgegebenen Informationen in Bytes an den von pcbNeeded angegebenen Speicherort schreibt.

Wenn pBufferNULL ist, sollte die Methode einfach pcbNeeded verwenden, um die Anzahl von Bytes zurückzugeben, die zum Speichern der angegebenen Informationen erforderlich sind.

Weitere Informationen zum Erstellen und Installieren von Benutzeroberfläche-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.

Anforderungen

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

Weitere Informationen

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo