Función IsValidDevmodeW (winspool.h)
La función IsValidDev mode del administrador de impresión comprueba que el contenido de una estructura de DEVMODE sea válida.
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 realiza correctamente la reparación de la estructura 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.
Observaciones
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 dmSize miembro 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 tan grande.
Esta función no requiere que el autor de la llamada obtenga privilegios elevados.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Escritorio |
encabezado de | winspool.h (incluya Winspool.h) |
biblioteca de | Winspool.lib |
DLL de | Winspool.drv |