TTGetEmbeddingType function (t2embapi.h)

Article
02/22/2024

Obtains the embedding privileges of a font.

Syntax

LONG TTGetEmbeddingType(
  [in] HDC   hDC,
  [in] ULONG *pulEmbedType
);

Parameters

[in] hDC

Device context handle.

[in] pulEmbedType

Pointer to flag indicating embedding privileges of the font. This flag can have one of the following values. This function returns the least restrictive license granted.

Value	Meaning
EMBED_PREVIEWPRINT	Preview and Print Embedding.
EMBED_EDITABLE	Editable Embedding.
EMBED_INSTALLABLE	Installable Embedding.
EMBED_NOEMBEDDING	Restricted License Embedding.

Return value

If successful, returns E_NONE.

This function reads the embedding privileges stored in the font and transfers the privileges to pulPrivStatus.

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

Remarks

Alternatively, an application can determine embedding privileges by using TTLoadEmbeddedFont and then checking the value returned in pulPrivStatus for success or failure of the function.

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