Функция 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 |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |