IDWriteFactory::CreateFontFileReference-Methode (dwrite.h)
Erstellt ein Schriftartdateiverweisobjekt aus einer lokalen Schriftartdatei.
Syntax
HRESULT CreateFontFileReference(
[in] WCHAR const *filePath,
[in, optional] FILETIME const *lastWriteTime,
[out] IDWriteFontFile **fontFile
);
Parameter
[in] filePath
Typ: const WCHAR*
Ein Array von Zeichen, das den absoluten Dateipfad für die Schriftartdatei enthält. Nachfolgende Vorgänge für das erstellte Objekt können fehlschlagen, wenn der Benutzer filePath nicht einer gültigen Datei auf dem Datenträger entspricht.
[in, optional] lastWriteTime
Typ: const FILETIME*
Der Zeitpunkt der letzten Änderung des Eingabedateipfads. Wenn der Parameter nicht angegeben wird, greift die Funktion auf die Schriftartdatei zu, um die letzte Schreibzeit zu erhalten. Sie sollten diesen Wert angeben, um zusätzlichen Datenträgerzugriff zu vermeiden. Nachfolgende Vorgänge für das erstellte Objekt können fehlschlagen, wenn der Benutzer lastWriteTime nicht mit der Datei auf dem Datenträger übereinstimmt.
[out] fontFile
Typ: IDWriteFontFile**
Wenn diese Methode zurückgegeben wird, enthält sie eine Adresse eines Zeigers auf das neu erstellte Referenzobjekt der Schriftartdatei oder NULL- im Falle eines Fehlers.
Rückgabewert
Typ: HRESULT-
Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | dwrite.h |
| Library | Dwrite.lib |
| DLL- | Dwrite.dll |