OleCreateFontIndirect-Funktion (olectl.h)

  • Artikel

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