TTGetEmbeddedFontInfo-Funktion (t2embapi.h)

  • Artikel

Ruft Informationen zu einer eingebetteten Schriftart ab, z. B. einbetten von Berechtigungen. TTGetEmbeddedFontInfo führt dieselbe Aufgabe wie TTLoadEmbeddedFont aus, weist jedoch keine internen Datenstrukturen für die eingebettete Schriftart zu.

Syntax

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

Parameter

[in] ulFlags

Flags, die die Anforderung angeben. Dieses Flag kann null oder mehr der folgenden Werte aufweisen.

Wert Bedeutung
TTEMBED_EMBEDEUDC
 Fügen Sie die zugehörigen DATEN der EUDC-Schriftartdatei in die Schriftartstruktur ein.
TTEMBED_RAW
 Gibt eine Schriftartstruktur zurück, die den vollständigen Zeichensatz nicht komprimiert enthält. Dies ist das Standardverhalten der Funktion.
TTEMBED_SUBSET
 Gibt eine untergeordnete Schriftart zurück, die nur die durch den Parameter pusCharCodeSet oder pulCharCodeSet angegebenen Glyphen enthält. Diese Zeichencodes müssen entsprechend dem Parameter als 16-Bit- oder UCS-4-Zeichen bezeichnet werden.
TTEMBED_TTCOMPRESSED
 Gibt eine komprimierte Schriftartstruktur zurück.

[out] pulPrivStatus

Gibt nach Abschluss die Einbettungsberechtigungen der Schriftart an. Es folgt eine Liste möglicher Werte:

Wert Bedeutung
EMBED_PREVIEWPRINT
 Vorschau- und Druckeinbettung.
EMBED_EDITABLE
 Bearbeitbare Einbettung.
EMBED_INSTALLABLE
 Installierbare Einbettung.
EMBED_NOEMBEDDING
 Eingeschränkte Lizenzeinbettung.

[in] ulPrivs

Flag, das eine weitere Einschränkung der Einbettungsberechtigungen angibt, die vom Client auferlegt werden. Weitere Informationen finden Sie unter TTLoadEmbeddedFont .

Dieses Flag muss über einen der folgenden Werte verfügen.

Wert Bedeutung
LICENSE_PREVIEWPRINT
 Vorschau- und Druckeinbettung.
LICENSE_EDITABLE
 Bearbeitbare Einbettung.
LICENSE_INSTALLABLE
 Installierbare Einbettung.
LICENSE_NOEMBEDDING
 Eingeschränkte Lizenzeinbettung.
LICENSE_DEFAULT
 Verwenden Sie die Standardeinbettungsebene.

[out] pulStatus

Zeiger auf ein Bitfeld, das status Informationen enthält, und wird nach Abschluss dieser Funktion ausgefüllt. Der status kann null oder der folgende Wert sein:

Wert Bedeutung
TTLOAD_FONT_SUBSETTED
 Die geladene Schriftart ist eine Teilmenge der ursprünglichen Schriftart.

lpfnReadFromStream

[Rückruf] Zeiger auf die clientdefinierte Rückruffunktion, die die Schriftartstruktur aus dem Dokumentstream liest.

[in] lpvReadStream

Derzeit undefiniert. Reserviert für einen Zeiger auf den Stream (Schriftartstruktur).

[in] pTTLoadInfo

Zeiger auf eine TTLOADINFO-Struktur , die die URL enthält, aus der das eingebettete Schriftartobjekt abgerufen wurde.

Rückgabewert

Bei erfolgreicher Ausführung wird E_NONE zurückgegeben.

Die Position, auf die von *pulPrivStatus verwiesen wird, identifiziert Einbettungsberechtigungen der Schriftart. Die Position, auf die von *pulStatus verwiesen wird, gibt an, ob eine Teilmenge der Schriftart eingebettet ist.

Andernfalls wird ein Fehlercode zurückgegeben, der unter Embedding-Function Error Messages beschrieben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile t2embapi.h
Bibliothek T2embed.lib
DLL T2embed.dll

Weitere Informationen

TTGetEmbeddingType

TTGetNewFontName

TTLOADINFO

TTLoadEmbeddedFont