Compartilhar via


Função TTDeleteEmbeddedFont (t2embapi.h)

Libera a memória usada por uma fonte inserida, hFontReference.

Por padrão, TTDeleteEmbeddedFont também remove a versão instalada da fonte do sistema do usuário. Quando uma fonte instalável é carregada, essa função ainda deve ser chamada para liberar a memória usada pela estrutura de fonte inserida, mas um sinalizador pode ser especificado indicando que a fonte deve permanecer instalada no sistema.

Sintaxe

LONG TTDeleteEmbeddedFont(
  [in]  HANDLE hFontReference,
  [in]  ULONG  ulFlags,
  [out] ULONG  *pulStatus
);

Parâmetros

[in] hFontReference

Manipule a fonte de identificação, conforme fornecido na função TTLoadEmbeddedFont .

[in] ulFlags

Sinalizador especificando opções de exclusão de fonte. Atualmente, esse sinalizador pode ser definido como zero ou o seguinte valor:

Valor Significado
TTDELETE_DONTREMOVEFONT
Não remova a fonte instalada do sistema, mas libere a memória ocupada anteriormente pela estrutura de fonte inserida.

[out] pulStatus

Atualmente indefinido.

Retornar valor

Se tiver êxito, TTDeleteEmbeddedFont retornará um valor de E_NONE.

A memória ocupada pela estrutura de fonte inserida é desmarcada. Por padrão, a fonte indicada por hFontReference também é removida permanentemente (desinstalada e excluída) do sistema.

Caso contrário, retornará um código de erro descrito em Mensagens de Erro da Função de Inserção.

Comentários

O cliente é responsável por chamar essa função para remover fontes quando os privilégios de inserção não permitem que uma fonte seja instalada permanentemente no sistema de um usuário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho t2embapi.h
Biblioteca T2embed.lib
DLL T2embed.dll

Confira também

TTLoadEmbeddedFont