Metodo IPrintOemUI::GetInfo (prcomoem.h)
Il metodo di IPrintOemUI::GetInfo di un'interfaccia utente restituisce informazioni di identificazione.
Sintassi
HRESULT GetInfo(
DWORD dwMode,
PVOID pBuffer,
DWORD cbSize,
PDWORD pcbNeeded
);
Parametri
dwMode
Contiene una delle costanti integer fornite dal chiamante seguenti.
OEMGI_GETREQUESTEDHELPERINTERFACES
Il metodo deve scrivere il valore del flag di bit di OEMPUBLISH_IPRINTCOREHELPER nel buffer pBuffer se il metodo IPrintOemUI::P ublishDriverInterface deve essere chiamato con il parametro pIUnknown che punta a un oggetto che implementa l'interfaccia IPrintCoreHelperPS o interfaccia IPrintCoreHelperUni.
OEMGI_GETSIGNATURE
Il metodo deve restituire una firma di identificazione a quattro byte univoca. Il plug-in deve anche inserire questa firma nelle strutture OPTITEM, come descritto nella descrizione del membro OEMCUIPPARAM struttura pOEMOptItems.
OEMGI_GETVERSION
Il metodo deve restituire il numero di versione del plug-in dell'interfaccia utente come DWORD. Il formato della versione è definito dallo sviluppatore.
pBuffer
Puntatore fornito dal chiamante alla memoria allocata per ricevere le informazioni specificate da dwMode.
cbSize
Dimensione fornita dal chiamante del buffer a cui punta pBuffer.
pcbNeeded
Puntatore fornito dal chiamante a una posizione per ricevere il numero di byte scritti nel buffer a cui punta pBuffer.
Valore restituito
Il metodo deve restituire uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita. |
|
Operazione non riuscita. |
|
Il metodo non è implementato. |
Osservazioni
I plug-in dell'interfaccia utente sono necessari per implementare il metodo IPrintOemUI::GetInfo, che viene chiamato immediatamente dopo il caricamento del plug-in. Il metodo deve restituire le informazioni specificate scrivendolo nell'indirizzo specificato da pBuffer e scrivendo le dimensioni, in byte, delle informazioni restituite nella posizione specificata da pcbNeeded.
Se pBuffer è NULL, il metodo deve usare solo pcbNeeded per restituire il numero di byte necessari per archiviare le informazioni specificate.
Per altre informazioni sulla creazione e l'installazione di plug-in dell'interfaccia utente, vedere Personalizzazione dei driver della stampante di Microsoft.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |