通过

OleCreateFontIndirect 函数 (olectl.h)

  • 项目

使用 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
标头 olectl.h
Library OleAut32.lib
DLL OleAut32.dll

另请参阅

FONTDESC