TTIsEmbeddingEnabledForFacename function (t2embapi.h)

Article
02/22/2024

Determines whether embedding is enabled for a specified font.

Syntax

LONG TTIsEmbeddingEnabledForFacename(
  [in]  LPCSTR lpszFacename,
  [out] BOOL   *pbEnabled
);

Parameters

[in] lpszFacename

Pointer to the facename of the font, such as Arial Bold.

[out] pbEnabled

Pointer to a boolean, set upon completion of the function. A nonzero value indicates the font is not in the typeface exclusion list, and, therefore, can be embedded without conflict.

Return value

If successful, returns E_NONE.

pbEnabled is filled with a boolean that indicates whether embedding is currently enabled within a device context for the specified font.

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

Remarks

If successful, the client may embed the font.

For additional information on the exclusion list, see the Remarks section of TTEnableEmbeddingForFacename.

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