IPrintOemUI::GetInfo-Methode (prcomoem.h)
Die IPrintOemUI::GetInfo Methode eines Benutzeroberflächen-Plug-Ins gibt Identifikationsinformationen 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 Bitkennzeichnungswert OEMPUBLISH_IPRINTCOREHELPER in den Puffer schreiben, pBuffer, wenn die IPrintOemUI::P ublishDriverInterface-Methode sein sollte. wird mit Parametern pIUnknown aufgerufen, das auf ein Objekt zeigt, das die IPrintCoreHelperPS Interface oder IPrintCoreHelperUni Interfaceimplementiert.
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 OEMCUIPPARAMpOEMOptItems Members beschrieben.
OEMGI_GETVERSION
Die Methode muss die Versionsnummer des Plug-Ins der Benutzeroberfläche als DWORD zurückgeben. Das Versionsformat ist vom Entwickler definiert.
pBuffer
Vom Aufrufer bereitgestellter Zeiger auf den Speicher, der für den Empfang der durch dwModeangegebenen Informationen zugewiesen ist.
cbSize
Vom Aufrufer bereitgestellte Größe des Puffers, auf den pBuffer-verweist.
pcbNeeded
Vom Aufrufer bereitgestellter Zeiger auf eine Position, um die Anzahl der in den Puffer geschriebenen Bytes zu empfangen, auf die durch pBuffer-verwiesen wird.
Rückgabewert
Die Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang war erfolgreich. |
|
Fehler beim Vorgang. |
|
Die Methode ist nicht implementiert. |
Bemerkungen
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 in die durch pBuffer angegebene Adresse geschrieben und die Größe der zurückgegebenen Informationen in Byte in die durch pcbNeedededangegebene Position geschrieben.
Wenn pBuffer-NULL-ist, sollte die Methode nur pcbNeed verwenden, um die Anzahl der Bytes zurückzugeben, die zum Speichern der angegebenen Informationen erforderlich sind.
Weitere Informationen zum Erstellen und Installieren von Plug-Ins für die Benutzeroberfläche finden Sie unter Anpassen der Druckertreiber von Microsoft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | prcomoem.h (einschließlich Prcomoem.h) |