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

El método IPrintOemUI::GetInfo de un complemento de interfaz de 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 pBuffer si el método IPrintOemUI::P ublishDriverInterface debe ser se llama con el parámetro pIUnknown apuntando a un objeto que implementa la interfaz IPrintCoreHelperPS o IPrintCoreHelperUni Interface.

OEMGI_GETSIGNATURE

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

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 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 se implementa.

Observaciones

Los complementos de interfaz de usuario son necesarios para implementar el método IPrintOemUI::GetInfo, 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 pcbNeededed.

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 Personalización de los controladores de impresora de Microsoft.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de prcomoem.h (include Prcomoem.h)

Consulte también

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo