TTDeleteEmbeddedFont, fonction (t2embapi.h)

Article
08/26/2023

Libère la mémoire utilisée par une police incorporée, hFontReference.

Par défaut, TTDeleteEmbeddedFont supprime également la version installée de la police du système de l’utilisateur. Lorsqu’une police installable est chargée, cette fonction doit toujours être appelée pour libérer la mémoire utilisée par la structure de police incorporée, mais un indicateur peut être spécifié indiquant que la police doit rester installée sur le système.

Syntaxe

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

Paramètres

[in] hFontReference

Gérez la police d’identification, comme fourni dans la fonction TTLoadEmbeddedFont .

[in] ulFlags

Indicateur spécifiant les options de suppression de police. Actuellement, cet indicateur peut être défini sur zéro ou la valeur suivante :

Valeur	Signification
TTDELETE_DONTREMOVEFONT	Ne supprimez pas la police installée du système, mais libérez la mémoire précédemment occupée par la structure de police incorporée.

[out] pulStatus

Actuellement non défini.

Valeur retournée

En cas de réussite, TTDeleteEmbeddedFont retourne une valeur de E_NONE.

La mémoire occupée par la structure de police incorporée est effacée. Par défaut, la police indiquée par hFontReference est également définitivement supprimée (désinstallée et supprimée) du système.

Dans le cas contraire, retourne un code d’erreur décrit dans Messages d’erreur d’incorporation de la fonction.

Remarques

Le client est responsable de l’appel de cette fonction pour supprimer les polices lorsque les privilèges d’incorporation ne permettent pas d’installer définitivement une police sur le système d’un utilisateur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	t2embapi.h
Bibliothèque	T2embed.lib
DLL	T2embed.dll

Voir aussi

TTLoadEmbeddedFont

Partager via