IDWriteFactory::CreateFontFileReference-Methode (dwrite.h)
Erstellt ein Verweisobjekt für eine Schriftartdatei 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 konstruierte Objekt können fehlschlagen, wenn der vom Benutzer bereitgestellte 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 ausgelassen 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 konstruierte Objekt können fehlschlagen, wenn der vom Benutzer bereitgestellte lastWriteTime nicht mit der Datei auf dem Datenträger übereinstimmt.
[out] fontFile
Typ: IDWriteFontFile**
Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das neu erstellte Verweisobjekt der Schriftartdatei oder NULL im Falle eines Fehlers.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |