OleCreateFontIndirect-Funktion (olectl.h)

Artikel
03/01/2024

Erstellt und initialisiert ein Standardschriftartobjekt unter Verwendung einer ersten Beschreibung der Eigenschaften der Schriftart in einer FONTDESC-Struktur . Die Funktion gibt einen Schnittstellenzeiger auf das vom Aufrufer im riid-Parameter angegebene neue Schriftartobjekt zurück. Ein QueryInterface-Aufruf ist Teil dieses Aufrufs. Der Aufrufer ist für den Aufruf von Release über den zurückgegebenen Schnittstellenzeiger verantwortlich.

Syntax

WINOLECTLAPI OleCreateFontIndirect(
  [in]  LPFONTDESC lpFontDesc,
  [in]  REFIID     riid,
  [out] LPVOID     *lplpvObj
);

Parameter

[in] lpFontDesc

Adresse einer vom Aufrufer zugewiesenen FONTDESC-Struktur , die den Anfangszustand der Schriftart enthält. Dieser Wert darf nicht NULL sein.

[in] riid

Verweis auf den Bezeichner der Schnittstelle, die den Typ des zurückzugebenden Schnittstellenzeigers in lplpvObj beschreibt.

[out] lplpvObj

Adresse der Zeigervariable, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält dieser Parameter den angeforderten Schnittstellenzeiger für das neu erstellte Schriftartobjekt. Bei erfolgreicher Ausführung ist der Aufrufer dafür verantwortlich, Release über diesen Schnittstellenzeiger aufzurufen, wenn das neue Objekt nicht mehr benötigt wird. Wenn der Wert von nicht erfolgreich ist, wird der Wert von auf NULL festgelegt.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
E_NOINTERFACE	Der angegebene Schnittstellenbezeichner ist ungültig.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher für den Vorgang.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_POINTER	Die Adresse in pFontDesc oder ppvObj ist ungültig. Beachten Sie, dass die Funktion NO_ERROR zurückgibt, wenn pFontDesc auf NULL festgelegt ist.

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	olectl.h
Bibliothek	OleAut32.lib
DLL	OleAut32.dll

Weitere Informationen

FONTDESC

Freigeben über