Creates a font structure containing the subsetted wide-character (16-bit) font. An external file provides the font information.
This function passes the data to a client-defined callback routine for insertion into the document stream.
LONG TTEmbedFontFromFileA( HDC hDC, LPCSTR szFontFileName, USHORT usTTCIndex, ULONG ulFlags, ULONG ulCharSet, ULONG *pulPrivStatus, ULONG *pulStatus, WRITEEMBEDPROC lpfnWriteToStream, LPVOID lpvWriteStream, USHORT *pusCharCodeSet, USHORT usCharCodeCount, USHORT usLanguage, TTEMBEDINFO *pTTEmbedInfo );
Device context handle.
The font file name and path to embed. This is an ANSI string.
Zero-based index into the font file (TTC) identifying the physical font to embed. If the file contains a single font (such as a TTF or OTF outline file), this parameter should be set to 0.
Flag specifying the embedding request. This flag can have zero or more of the following values.
Flag specifying the character set of the font to be embedded. This flag can have one of the following values.
||Unicode character set, requiring 16-bit character encoding.|
||Symbol character set, requiring 16-bit character encoding.|
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.
||Preview and Print Embedding.|
||Restricted License Embedding.|
Pointer to a bitfield containing status information about the embedding request. This field is filled upon completion of this function. No bits are currently defined for this parameter.
Pointer to the client-defined callback function that writes the font structure to the document stream. See WRITEEMBEDPROC.
A token to represent the output stream.
Pointer to the buffer containing the optional Unicode character codes for subsetting. This field is only used for subsetting a font and is ignored if theulFlagsfield does not specify TTEMBED_SUBSET.
The number of characters in the list of characters indicated by pusCharCodeSet. This field is only used for subsetting a font and is ignored if the ulFlags field does not specify TTEMBED_SUBSET.
Specifies which language in the name table to keep when subsetting. Set to 0 to keep all languages. This field is only used for subsetting a font and is ignored if the ulFlags field does not specify TTEMBED_SUBSET.
Pointer to a TTEMBEDINFO structure containing the URLs from which the embedded font object may be legitimately referenced. If pTTEmbedInfo is NULL, no URLs will be added to the embedded font object and no URL checking will occur when the client calls the TTLoadEmbeddedFont function.
If the embedding is successful, returns E_NONE.
The font structure is incorporated into the document stream by the client. pulPrivStatus is set, indicating the embedding privileges of the font; and pulStatus is set to provide results of the embedding operation.
Otherwise, returns an error code described in Embedding-Function Error Messages.
This function references a client-defined callback routine for embedding the font structure into the document stream.
Clients are responsible for determining and indicating the character set of the font.
|Windows version||Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]|