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

O IPrintOemUI::UpdateExternalFonts método 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 heap de memória 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.

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

Um plug-in de interface do usuário deverá implementar o IPrintOemUI::UpdateExternalFonts método 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 IPrintOemUI::UpdateExternalFonts finalidade do método é 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. (Esse arquivo .uff também pode conter descrições de fontes suaves para download pcl.)

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
Plataforma de Destino	Área de Trabalho
Cabeçalho	prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintOemUI

IPrintOemUI::FontInstallerDlgProc