Función AddForm

La función AddForm agrega un formulario a la lista de formularios disponibles que se pueden seleccionar para la impresora especificada.

Sintaxis

BOOL AddForm(
  _In_ HANDLE hPrinter,
  _In_ DWORD  Level,
  _In_ LPBYTE pForm
);

Parámetros

hPrinter [in]

Identificador de la impresora que admite la impresión con el formulario especificado. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.

Nivel [in]

Nivel de la estructura a la que apunta pForm . Este valor debe ser 1 o 2.

pForm [in]

Puntero a una estructura de FORM_INFO_1 o FORM_INFO_2 .

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 que 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 del controlador 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.

Una aplicación puede determinar qué formularios están disponibles para una impresora mediante una llamada a la función EnumForms .

Si pForm apunta a un FORM_INFO_2, AddForm producirá un error si ya existe un formulario con el nombre especificado o el valor pKeyword de la estructura ya existe.

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	Spoolss.dll

Consulte también

Impresión

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

EnumForms

FORM_INFO_1

FORM_INFO_2

OpenPrinter