Función ResetPrinter

La función ResetPrinter especifica los valores de tipo de datos y modo de dispositivo que se usarán para imprimir documentos enviados por la función StartDocPrinter . Estos valores se pueden invalidar mediante la función SetJob una vez iniciada la impresión de documentos.

Sintaxis

BOOL ResetPrinter(
  _In_ HANDLE             hPrinter,
  _In_ LPPRINTER_DEFAULTS pDefault
);

Parámetros

hPrinter [in]

Maneje la impresora. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.

pDefault [in]

Puntero a una estructura de PRINTER_DEFAULTS .

La función ResetPrinter omite el miembro DesiredAccess de la estructura PRINTER_DEFAULTS . Establezca ese miembro en cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Nota

Se trata de una función de bloqueo o sincrónica y podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación de controladores de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winspool.h (incluye Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Winspool.drv
Nombres Unicode y ANSI	ResetPrinterW (Unicode) y ResetPrinterA (ANSI)

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

OpenPrinter

PRINTER_DEFAULTS

StartDocPrinter

SetJob