IFont::get_hFont 方法 (ocidl.h)

检索此字体对象描述的字体的句柄。

语法

HRESULT get_hFont(
  [out] HFONT *phFont
);

parameters

[out] phFont

指向调用方分配的变量的指针,该变量接收字体句柄。 调用方不拥有此资源,不得尝试销毁字体。

返回值

方法支持 E_UNEXPECTEDE_OUTOFMEMORY的标准返回值,以及以下值。

返回代码 说明
S_OK
已成功检索字体句柄。
E_POINTER
phFont 参数中的地址无效。 例如,它可能为 NULL

注解

给调用方的说明

字体对象保留 HFONT 的所有权,并且可以随时销毁它,而无需事先通知。 如果调用方需要在有限的时间内保护此字体,则可以调用 IFont::AddRefHfontIFont::ReleaseHfont

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

请参阅

IFont

IFont::AddRefHfont

IFont::ReleaseHfont