Функция OleCreateFontIndirect (olectl.h)

Статья
08/25/2023

Создает и инициализирует стандартный объект шрифта, используя начальное описание свойств шрифта в структуре FONTDESC . Функция возвращает указатель интерфейса на новый объект шрифта, указанный вызывающим объектом в параметре riid. Вызов QueryInterface является частью этого вызова. Вызывающий объект отвечает за вызов Release через возвращенный указатель интерфейса.

Синтаксис

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

Параметры

[in] lpFontDesc

Адрес выделенной вызывающим объектом структуры FONTDESC , содержащей начальное состояние шрифта. Это значение не должно иметь значение NULL.

[in] riid

Ссылка на идентификатор интерфейса, описывающий тип возвращаемого указателя интерфейса в lplpvObj.

[out] lplpvObj

Адрес переменной указателя, получающей указатель интерфейса, запрошенный в riid. После успешного возврата этот параметр содержит запрошенный указатель интерфейса на созданный объект шрифта. В случае успеха вызывающий объект отвечает за вызов Release через этот указатель интерфейса, когда новый объект больше не нужен. В случае неудачи для параметра устанавливается значение NULL.

Возвращаемое значение

Эта функция возвращает S_OK при успешном выполнении. Ниже перечислены другие возможные значения.

Код возврата	Описание
E_NOINTERFACE	Предоставленный идентификатор интерфейса недопустим.
E_UNEXPECTED	Произошла непредвиденная ошибка.
E_OUTOFMEMORY	Недостаточно памяти для операции.
E_INVALIDARG	Один или несколько параметров недопустимы.
E_POINTER	Недопустимый адрес в pFontDesc или ppvObj . Обратите внимание, что если pFontDesc имеет значение NULL, функция возвращает NO_ERROR.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	olectl.h
Библиотека	OleAut32.lib
DLL	OleAut32.dll

См. также раздел

FONTDESC

Поделиться через