TTDeleteEmbeddedFont, fonction (t2embapi.h)

  • Article

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