Функция IsValidDevmodeW (winspool.h)
Функция IsValidDevmode средства печати проверяет допустимость содержимого структуры DEVMODE .
Синтаксис
BOOL IsValidDevmodeW(
[in, optional] PDEVMODEW pDevmode,
size_t DevmodeSize
);
Параметры
[in, optional] pDevmode
Указатель на проверяемую структуру DEVMODE.
DevmodeSize
Размер буфера, на который указывает pDevmode, в байтах.
Возвращаемое значение
Если структура DEVMODE допустима или если функции удалось восстановить структуру, чтобы сделать ее допустимой, функция возвращает значение TRUE. В противном случае функция возвращает значение FALSE. Вызывающий объект может получить код ошибки, вызвав Метод GetLastError.
Комментарии
Перед использованием структуры DEVMODE, полученной из источника, возможно, ненадежного, драйвер принтера может вызвать эту функцию, чтобы убедиться, что структура является допустимой. Эта функция проверяет только открытые элементы структуры DEVMODE. Он не проверка закрытых членов структуры.
Элемент dmSize структуры DEVMODE указывает размер структуры DEVMODE, не включая частные данные, указанные драйвером, добавленные в структуру. Член dmDriverExtra указывает размер частных данных, добавляемых в структуру, если таковые имеются. Вызывающие стороны должны задать для DevModeSize значение dmSize+dmDriverExtra только в том случае, если они могут гарантировать, что размер входного буфера не ниже этого.
Для этой функции не требуется, чтобы вызывающий объект получать повышенные привилегии.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winspool.h (включая Winspool.h) |
| Библиотека | Winspool.lib |
| DLL | Winspool.drv |