TTEnableEmbeddingForFacename function (t2embapi.h)

Adds or removes facenames from the typeface exclusion list.

Syntax

LONG TTEnableEmbeddingForFacename(
  [in] LPCSTR lpszFacename,
  [in] BOOL   bEnable
);

Parameters

[in] lpszFacename

Pointer to the facename of the font to be added or removed from the typeface exclusion list.

[in] bEnable

Boolean controlling operation on typeface exclusion list. If nonzero, then the facename will be removed from the list; if zero, the facename will be added to the list.

Return value

If successful, returns E_NONE.

The facename indicated by lpszFacename will be added or removed from the typeface exclusion list.

Otherwise, returns an error code described in Embedding-Function Error Messages.

Remarks

The function TTEnableEmbeddingForFacename uses a typeface exclusion list to control whether a specific font can be embedded. This list identifies all fonts that should NOT be embedded and is shared by all authoring clients on a single system.

An authoring client can embed fonts without referencing the typeface exclusion list (that is, without using TTEnableEmbeddingForFacename). Embedding fonts in a document results in the following tradeoffs.

• Provides all font information within a document so the appropriate client can render the document.
• Adds size to a document.
• Complicates streaming read and write operations to a document and uses more processing bandwidth.
• Makes a document less readable by other applications.
• Can leave copyright issues unmanaged, if the type exclusion list is not used.

The typeface exclusion list is stored in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embed. The default typeface exclusion list should contain the following named value entries representing the Microsoft Windows core fonts.

Requirements

See also

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename