Edit

Share via

TTGetNewFontName function (t2embapi.h)

  • Article

Obtains the family name for the font loaded through TTLoadEmbeddedFont.

Syntax

LONG TTGetNewFontName(
  [in]  HANDLE *phFontReference,
  [out] LPWSTR wzWinFamilyName,
  [in]  LONG   cchMaxWinName,
  [out] LPSTR  szMacFamilyName,
  [in]  LONG   cchMaxMacName
);

Parameters

[in] phFontReference

Handle that identifies the embedded font that has been installed. The handle references an internal structure, not an Hfont.

[out] wzWinFamilyName

Buffer to hold the new 16-bit-character Microsoft Windows family name.

[in] cchMaxWinName

Length of the string allocated for the Windows name (szWinFamilyName). Must be at least LF_FACESIZE long.

[out] szMacFamilyName

Buffer to hold the new 8-bit-character MacIntosh family name.

[in] cchMaxMacName

Length of the string allocated for the Macintosh name (szMacFamilyName). Must be at least LF_FACESIZE long.

Return value

If successful, returns E_NONE.

The font family name is a string in szWinFamilyName or szMacFamilyName.

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

Remarks

Note  This function returns the font family name in the appropriate string buffer, either for Windows or the MacIntosh. The buffer for the other operating system is not used.
 

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

TTGetEmbeddingType

TTLoadEmbeddedFont