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

Функция IsValidDevmodeA (winspool.h)

  • Статья

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

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

DEVMODE