TTIsEmbeddingEnabled function (t2embapi.h)

Determines whether the typeface exclusion list contains a specified font.

Syntax

LONG TTIsEmbeddingEnabled(
  [in]  HDC  hDC,
  [out] BOOL *pbEnabled
);

Parameters

[in] hDC

Device context handle.

[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.

The parameter pbEnabled is filled with a boolean that indicates whether embedding is currently enabled within a device context.

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

Remarks

If the specified font is listed, the client should not 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

TTIsEmbeddingEnabledForFacename