Metodo IPrintOemUI::GetInfo (prcomoem.h)

Articolo
02/26/2024

Il metodo del plug-in dell'interfaccia IPrintOemUI::GetInfo 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 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 pOEMOptItems della struttura OEMCUIPPARAM.

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 allocato per ricevere le informazioni specificate da dwMode.

cbSize

Dimensioni fornite dal chiamante del buffer a cui fa riferimento 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
S_OK	Operazione completata.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Commenti

I plug-in dell'interfaccia utente sono necessari per implementare il metodo, che viene chiamato immediatamente dopo il IPrintOemUI::GetInfo caricamento del plug-in. Il metodo deve restituire le informazioni specificate scrivendolo all'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 il pcbNeeded per restituire il numero di byte necessari per archiviare le informazioni specificate.

Per altre informazioni sulla creazione e l'installazione dei plug-in dell'interfaccia utente, vedere Personalizzazione dei driver di stampante microsoft.