TTGetEmbeddingType function (t2embapi.h)

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

See also

TTGetEmbeddedFontInfo

TTGetNewFontName

TTLoadEmbeddedFont