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

  • Artigo

O método de um plug-in de interface do IPrintOemUI::GetInfo usuário retorna informações de identificação.

Sintaxe

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

Parâmetros

dwMode

Contém uma das seguintes constantes inteiros fornecidas pelo chamador.

OEMGI_GETREQUESTEDHELPERINTERFACES

O método deverá gravar o valor do sinalizador de bit de OEMPUBLISH_IPRINTCOREHELPER no buffer pBuffer se o método IPrintOemUI::P ublishDriverInterface deve ser chamado com o parâmetro pIUnknown apontando para um objeto que implementa a Interface IPrintCoreHelperPS ou interface IPrintCoreHelperUni.

OEMGI_GETSIGNATURE

O método deve retornar uma assinatura de identificação exclusiva de quatro bytes. O plug-in também deve colocar essa assinatura em estruturas OPTITEM, conforme descrito na descrição do membro pOEMOptItems da estrutura OEMCUIPPARAM.

OEMGI_GETVERSION

O método deve retornar o número de versão do plug-in da interface do usuário como um DWORD. O formato de versão é definido pelo desenvolvedor.

pBuffer

Ponteiro fornecido pelo chamador para a memória alocada para receber as informações especificadas por dwMode.

cbSize

Tamanho fornecido pelo chamador do buffer apontado por pBuffer.

pcbNeeded

Ponteiro fornecido pelo chamador para um local para receber o número de bytes gravados no buffer apontado por pBuffer.

Retornar valor

O método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_FAIL
 Falha na operação.
E_NOTIMPL
 O método não está implementado.

Comentários

Os plug-ins de interface do usuário são necessários para implementar o IPrintOemUI::GetInfo método , que é chamado imediatamente após o plug-in ser carregado. O método deve retornar as informações especificadas gravando-as no endereço especificado por pBuffer e gravando o tamanho, em bytes, das informações retornadas no local especificado por pcbNeeded.

Se pBuffer for NULL, o método deverá usar apenas pcbNeeded para retornar o número de bytes necessários para armazenar as informações especificadas.

Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando drivers de impressora da Microsoft.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo