TTIsEmbeddingEnabledForFacename function (t2embapi.h)

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

See also

TTEnableEmbeddingForFacename

TTGetEmbeddedFontInfo

TTGetEmbeddingType

TTIsEmbeddingEnabled