TTEmbedFont function (t2embapi.h)
Creates a font structure containing the subsetted wide-character (16-bit) font. The current font of the device context (hDC) provides the font information.
This function passes the data to a client-defined callback routine for insertion into the document stream.
LONG TTEmbedFont( HDC hDC, ULONG ulFlags, ULONG ulCharSet, ULONG *pulPrivStatus, ULONG *pulStatus, WRITEEMBEDPROC lpfnWriteToStream, LPVOID lpvWriteStream, USHORT *pusCharCodeSet, USHORT usCharCodeCount, USHORT usLanguage, TTEMBEDINFO *pTTEmbedInfo );
Device context handle.
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, which 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 the ulFlags field 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 TTLoadEmbeddedFont.
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.
Clients are responsible for determining and indicating the character set of the font.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|