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