Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft den Namen der Geräteschriftart ab.
Syntax
HRESULT GetDeviceFontName(
[out, retval] LPWSTR *deviceFontName
);
Parameter
[out, retval] deviceFontName
Die Zeichenfolge, die den Nichtzeichennamen der Geräteschriftart enthält. Wenn der Name nicht festgelegt wurde, wird ein NULL-Zeiger zurückgegeben.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
deviceFontName ist NULL. |
Hinweise
Der Name der Geräteschriftart identifiziert eine bestimmte Geräteschriftart eindeutig und wird in der Regel von einem Hardware- oder Schriftarthersteller definiert.
Die mit Escapezeichen versehene Version des Geräteschriftartennamens wird erstellt, wenn das Objekt serialisiert wird.
Diese Methode ordnet den Arbeitsspeicher zu, der von der in deviceFontName zurückgegebenen Zeichenfolge verwendet wird. Wenn deviceFontName nicht NULL ist, verwenden Sie die CoTaskMemFree-Funktion , um den Arbeitsspeicher freizugeben.
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 | xpsobjectmodel.h |