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


Метод IFont::get_hFont (ocidl.h)

Извлекает дескриптор шрифта, описанный этим объектом шрифта.

Синтаксис

HRESULT get_hFont(
  [out] HFONT *phFont
);

Параметры

[out] phFont

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

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

Метод поддерживает стандартные возвращаемые значения E_UNEXPECTED и E_OUTOFMEMORY, а также следующие значения.

Код возврата Описание
S_OK
Дескриптор шрифта успешно получен.
E_POINTER
Недопустимый адрес в параметре phFont . Например, он может иметь значение NULL.

Комментарии

Примечания к вызывающим абонентам

Объект шрифта сохраняет право собственности на HFONT и может уничтожить его в любое время без предварительного уведомления. Если вызывающему объекту необходимо защитить этот шрифт в течение ограниченного периода времени, он может вызывать IFont::AddRefHfont и IFont::ReleaseHfont.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

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

IFont

IFont::AddRefHfont

IFont::ReleaseHfont