AddFontMemResourceEx 函数 (wingdi.h)
AddFontMemResourceEx 函数将内存图像中的字体资源添加到系统。
语法
HANDLE AddFontMemResourceEx(
[in] PVOID pFileView,
[in] DWORD cjSize,
[in] PVOID pvResrved,
[in] DWORD *pNumFonts
);
参数
[in] pFileView
指向字体资源的指针。
[in] cjSize
pbFont 指向的字体资源中的字节数。
[in] pvResrved
保留。 必须为 0。
[in] pNumFonts
指向变量的指针,该变量指定已安装的字体数。
返回值
如果函数成功,则返回值指定所添加字体的句柄。 此句柄唯一标识安装在系统上的字体。 如果函数失败,则返回值为零。 没有可用的扩展错误信息。
注解
此函数允许应用程序获取嵌入在文档或网页中的字体。 由 AddFontMemResourceEx 添加的字体始终是调用进程的专用字体,并且不可枚举。
内存图像可以包含多个字体。 当此函数成功时, pcFonts 是指向 DWORD 的指针,其值为由于此调用而添加到系统的字体数。 例如,对于亚洲字体的垂直和水平面,此数字可以为 2。
函数成功后,此函数的调用方可以释放 pbFont 指向的内存,因为系统已创建自己的内存副本。 若要删除已安装的字体,请调用 RemoveFontMemResourceEx。 但是,当该过程消失时,即使进程未调用 RemoveFontMemResource,系统也会卸载字体。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |