Функция IsValidDevmode

Статья
06/13/2023

Функция IsValidDevmode проверяет допустимость содержимого структуры DEVMODE.

Синтаксис

BOOL IsValidDevmode(
  _In_ PDEVMODE pDevmode,
       size_t   DevmodeSize
);

Параметры

pDevmode [in]: Указатель на проверяемую модель DEVMODE .
DevmodeSize: Размер входного буфера байтов в байтах.

Возвращаемое значение

Значение TRUE, если DEVMODE является структурно допустимым. При обнаружении незначительных ошибок функция исправит их и вернет значение TRUE.

FALSE, если в DEVMODE есть одна или несколько существенных структурных проблем. Например, член dmSize не соответствует значению или задает слишком маленький буфер. Кроме того, значение FALSE , если pDevmode имеет значение NULL.

Вызывающие абоненты должны использовать dmSize+dmDriverExtra для DevmodeSize , только если они могут гарантировать, что размер входного буфера не ниже. Так как DEVMODE обычно является ненадежными данными, значения, которые находятся во входном буфере в смещениях dmSize и dmDriverExtra , также не являются доверенными.

Эта функция является исполняемой в контексте Least-Privileged учетной записи пользователя (LUA).

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Winspool.h
Библиотека	Winspool.lib
DLL	Winspool.drv
Имя в кодировке Юникод и ANSI	IsValidDevmodeW (Юникод) и IsValidDevmodeA (ANSI)

См. также раздел

Вывод на печать
Функции API очереди печати принтера
DEVMODE

Поделиться через