Font-Embedding Function Error Messages

The following LONG values are returned by the font-embedding functions when errors are encountered. When functions are successful, the value E_NONE is returned.

Return value	Description
E_NONE	No error.
E_ADDFONTFAILED	An error occurred when the load functions tried to add the new font using AddFontResource.
E_CHARCODECOUNTINVALID	The count of subsetted characters specified in TTEmbedFont is invalid.
E_CHARCODESETINVALID	The character set specified in TTEmbedFont is invalid.
E_COULDNTCREATETEMPFILE	The load functions could not create a temporary file needed in to install a new font or resource file.
E_DEVICETRUETYPEFONT	The specified TrueType® font is not a system font. The font may exist as a device font in a printer.
E_ERRORACCESSINGEXCLUDELIST	An error occurred while attempting to access the Typeface Exclusion List.
E_ERRORACCESSINGFACENAME	A non-DC-related error was encountered while trying to allocate an OUTLINETEXTMETRIC structure.
E_ERRORACCESSINGFONTDATA	An error was encountered while attempting to use GetFontData.
E_ERRORCOMPRESSINGFONTDATA	An error occurred while TTEmbedFont attempted to compress the font data.
E_ERRORCONVERTINGCHARS	An error prevented the conversion of a string of single-byte characters to Unicode characters. This can occur in TTCharToUnicode if either pucCharCodes or pusShortCodes are non-null values, or if the conversion fails while using MultiByteToWideChar.
E_ERRORCREATINGFONTFILE	An error occurred while attempting to create the font file.
E_ERRORDECOMPRESSINGFONTDATA	An error occurred while trying to decompress data in a font file.
E_ERROREXPANDINGFONTDATA	An error occurred while the load functions attempted to expand embedded, compressed font data.
E_ERRORGETTINGDC	An error occurred while trying to allocate a DC, halting processing.
E_ERRORREADINGFONTDATA	An error occurred while attempting to read font data.
E_ERRORUNICODECONVERSION	An error occurred while allocating memory to convert a name string to Unicode.
E_ERRORUSINGTEMPFILE	An error occurred while the load functions were using a temporary file to install a new font file or resource file.
E_EXCEPTION	An exception was thrown by an unknown cause.
E_FACENAMEINVALID	A null szFaceName parameter was passed to the function.
E_FLAGSINVALID	The ulFlags parameter in the current function is invalid.
E_FONTALREADYEXISTS	The embedded font has the same name and checksum as a font already installed on the system.
E_FONTDATAINVALID	Font data read from disk is not a valid embedded-font structure.
E_FONTFILECREATEFAILED	The load functions could not create the font file (.ttf)
E_FONTFILENOTFOUND	The font file of the specified file name does not exist.
E_FONTINSTALLFAILED	An attempt to install the embedded font in the system failed.
E_FONTNAMEALREADYEXISTS	The embedded font has the same name but a different checksum as a font already installed.
E_FONTNOTEMBEDDABLE	The specified font cannot be embedded due to restrictions from the font manufacturer. Embedding this font in a document violates copyright laws.
E_FONTREFERENCEINVALID	A null phFontReference was passed to the function.
E_HDCINVALID	The device context specified for the TTEmbedFont function is invalid.
E_NAMECHANGEFAILED	TTLoadEmbeddedFont was unable to change the name of the font being loaded.
E_NOFREEMEMORY	An internal operation failed while attempting to allocate memory.
E_NOOS2	An OS/2 table was not found in the font.
E_NOTATRUETYPEFONT	The specified font is not a TrueType font.
E_PBENABLEDINVALID	A null pbEnabled parameter was passed to the function.
E_PERMISSIONSINVALID	A null pulPermissions parameter was passed to the function.
E_PRIVSINVALID	The ulPrivs parameter specified in the load functions is invalid.
E_PRIVSTATUSINVALID	A null pulPrivStatus parameter was passed to the function.
E_READFROMSTREAMFAILED	An error occurred while attempting to read the embedded font structure from the stream.
E_RESOURCEFILECREATEFAILED	The load functions could not create the font resource file (.fot).
E_SAVETOSTREAMFAILED	An error occurred while attempting to save the embedded-font structure to a stream.
E_STATUSINVALID	A null pulStatus parameter was passed to the function.
E_STREAMINVALID	The stream specified in TTEmbedFont or the load functions is invalid.
E_SUBSETTINGFAILED	TTEmbedFont failed while attempting to create a subset of a font.
E_T2NOFREEMEMORY	An error occurred while attempting to free memory. The memory in question failed during the free operation.
E_WINDOWSAPI	An internal error occurred when one of the functions called a Windows API, such as GetTextMetrics or GetOutlineTextMetrics.
E_API_NOTIMPL	This API function is not implemented in the version of Windows on which it is running.