Función SetForm
La función SetForm establece la información del formulario para la impresora especificada.
Sintaxis
BOOL SetForm(
_In_ HANDLE hPrinter,
_In_ LPTSTR pFormName,
_In_ DWORD Level,
_In_ LPTSTR pForm
);
Parámetros
-
hPrinter [in]
-
Identificador de la impresora para la que se establece la información del formulario. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.
-
pFormName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del formulario para el que se establece la información del formulario.
-
Nivel [in]
-
Versión 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.
Se puede llamar a SetForm varias veces para una FORM_INFO_2 existente, cada llamada agrega pares adicionales de valores pDisplayName y wLangId. Todas las versiones de idiomas del formulario obtendrán los valores Size e ImageableArea del FORM_INFO_2 en la llamada más reciente a SetForm.
Si el autor de la llamada es remoto y el nivel es 2, el valor StringType del FORM_INFO_2 no puede ser STRING_MUIDLL.
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 |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
SetFormW (Unicode) y SetFormA (ANSI) |