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.

Two additional functions, TTIsEmbeddingEnabled and TTIsEmbeddingEnabledForFacename, access the typeface exclusion list to provide enabling status.

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.

Value name	Data type	Data value
Arial	REG_DWORD	0
Arial Bold	REG_DWORD	0
Arial Bold Italic	REG_DWORD	0
Arial Italic	REG_DWORD	0
Courier New	REG_DWORD	0
Courier New Bold	REG_DWORD	0
Courier New Bold Italic	REG_DWORD	0
Courier New Italic	REG_DWORD	0
Times New Roman	REG_DWORD	0
Times New Roman Bold	REG_DWORD	0
Times New Roman Bold Italic	REG_DWORD	0
Times New Roman Italic	REG_DWORD	0

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	t2embapi.h
Library	T2embed.lib
DLL	T2embed.dll

See also

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename