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 |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Fehler beim Vorgang. |
|
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) |