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 |