TTIsEmbeddingEnabled function (t2embapi.h)

Article
02/22/2024

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