Compartilhar via


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

O método IPrintOemUI::UpdateExternalFonts permite que um plug-in de interface do usuário atualize os arquivos de formato de fonte Unidrv de uma impressora (arquivo .uff).

Sintaxe

HRESULT UpdateExternalFonts(
  HANDLE hPrinter,
  HANDLE hHeap,
  PWSTR  pwstrCartridges
);

Parâmetros

hPrinter

Identificador de impressora fornecido pelo chamador.

hHeap

Identificador fornecido pelo chamador para memória de heap que o método pode usar para armazenamento local.

pwstrCartridges

Ponteiro fornecido pelo chamador para uma matriz de cadeias de caracteres que representam os nomes de todos os cartuchos atualmente instalados na impressora.

Valor de retorno

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

Código de retorno Descrição
S_OK
A operação foi bem-sucedida.
E_FAIL
Falha na operação.
E_NOTIMPL
O método não é implementado.

Observações

Um plug-in de interface do usuário deve implementar o método IPrintOemUI::UpdateExternalFonts se o plug-in estiver substituindo o instalador de fonte padrão do Unidrv. Para obter mais informações, consulte Instaladores de Fonte Personalizados para Unidrv.

A finalidade do método IPrintOemUI::UpdateExternalFonts é examinar a lista de cartuchos instalados (fornecidos por pwstrCartridges) e garantir que o arquivo .uff especificado pelo valor do registro "ExternalFontFile" contenha descrições de fonte apenas para as fontes de cartucho contidas nos cartuchos instalados. (Este arquivo .uff também pode conter descrições de pcl -fontes suaves para download.)

Descrições de fontes de cartucho podem ser copiadas do arquivo .uff especificado pelo valor do registro "ExtFontCartFile". Para obter mais informações, consulte Arquivos de Formato de Fonte Unidrv.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho prcomoem.h (inclua Prcomoem.h)

Consulte também

IPrintOemUI

IPrintOemUI::FontInstallerDlgProc