Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. |