Función IsValidDevmodeW (winspool.h)

La función IsValidDevmode del administrador de impresión comprueba que el contenido de una estructura DEVMODE es válido.

Sintaxis

BOOL IsValidDevmodeW(
  [in, optional] PDEVMODEW pDevmode,
                 size_t    DevmodeSize
);

Parámetros

[in, optional] pDevmode

Puntero a la estructura DEVMODE que se va a validar.

DevmodeSize

Tamaño, en bytes, del búfer al que apunta pDevmode.

Valor devuelto

Si la estructura DEVMODE es válida o si la función se repara correctamente para que sea válida, la función devuelve TRUE. De lo contrario, la función devuelve FALSE. El autor de la llamada puede obtener un código de error llamando a GetLastError.

Comentarios

Antes de usar una estructura DEVMODE obtenida de un origen posiblemente no confiable, un controlador de impresora puede llamar a esta función para comprobar que la estructura es válida. Esta función valida solo los miembros públicos de la estructura DEVMODE. No comprueba los miembros privados de la estructura.

El miembro dmSize de la estructura DEVMODE especifica el tamaño de la estructura DEVMODE, no incluidos los datos privados especificados por el controlador anexados a la estructura. El miembro dmDriverExtra especifica el tamaño de los datos privados anexados a la estructura, si hay alguno. Los autores de llamadas deben establecer DevModeSize en dmSize+dmDriverExtra solo si pueden garantizar que el tamaño del búfer de entrada sea al menos ese tamaño grande.

Esta función no requiere que el autor de la llamada obtenga privilegios elevados.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	winspool.h (incluya Winspool.h)
Library	Winspool.lib
Archivo DLL	Winspool.drv

Consulte también

DEVMODE