Método IPrintOemUI::GetInfo (prcomoem.h)

El método de un complemento de interfaz de IPrintOemUI::GetInfo usuario devuelve información de identificación.

Sintaxis

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

Parámetros

dwMode

Contiene una de las siguientes constantes de entero proporcionadas por el autor de la llamada.

OEMGI_GETREQUESTEDHELPERINTERFACES

El método debe escribir el valor de marca de bits de OEMPUBLISH_IPRINTCOREHELPER en el búfer pBuffer si se debe llamar al método IPrintOemUI::P ublishDriverInterface con el parámetro pIUnknown que apunta a un objeto que implementa la interfaz IPrintCoreHelperPS o la interfaz IPrintCoreHelperUni.

OEMGI_GETSIGNATURE

El método debe devolver una firma de identificación de cuatro bytes única. El complemento también debe colocar esta firma en estructuras OPTITEM, como se describe en la descripción del miembro pOEMOptItems de la estructura OEMCUIPPARAM.

OEMGI_GETVERSION

El método debe devolver el número de versión del complemento de la interfaz de usuario como DWORD. El formato de versión está definido por el desarrollador.

pBuffer

Puntero proporcionado por el autor de la llamada a la memoria asignada para recibir la información especificada por dwMode.

cbSize

Tamaño proporcionado por el autor de la llamada del búfer al que apunta pBuffer.

pcbNeeded

Puntero proporcionado por el autor de la llamada a una ubicación para recibir el número de bytes escritos en el búfer al que apunta pBuffer.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no está implementado.

Comentarios

Los complementos de interfaz de usuario son necesarios para implementar el IPrintOemUI::GetInfo método , al que se llama inmediatamente después de cargar el complemento. El método debe devolver la información especificada escribiendo en la dirección especificada por pBuffer y escribiendo el tamaño, en bytes, de la información devuelta en la ubicación especificada por pcbNeeded.

Si pBuffer es NULL, el método solo debe usar pcbNeeded para devolver el número de bytes necesarios para almacenar la información especificada.

Para obtener más información sobre cómo crear e instalar complementos de interfaz de usuario, vea Personalizar los controladores de impresora de Microsoft.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (incluya Prcomoem.h)

Consulte también

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo