Функция IsValidDevmodeA (winspool.h)
Функция spooler печати IsValidDevmode проверяет допустимость содержимого структуры DEVMODE.
Синтаксис
BOOL IsValidDevmodeA(
[in, optional] PDEVMODEA 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 (include Winspool.h) |
| библиотеки | Winspool.lib |
| DLL | Winspool.drv |