TTGetEmbeddedFontInfo-Funktion (t2embapi.h)

Artikel
08/26/2023

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

Freigeben über