Función SetDefaultPrinter
La función SetDefaultPrinter establece el nombre de la impresora predeterminada para el usuario actual en el equipo local.
Sintaxis
BOOL SetDefaultPrinter(
_In_ LPCTSTR pszPrinter
);
Parámetros
-
pszPrinter [in]
-
Puntero a una cadena terminada en null que contiene el nombre predeterminado de la impresora. Para una conexión de impresora remota, el formato de nombre es **\\server\**printername. Para una impresora local, el formato de nombre es printername.
Si este parámetro es NULL o una cadena vacía, es decir, "", SetDefaultPrinter seleccionará una impresora predeterminada de una de las impresoras instaladas. Si ya existe una impresora predeterminada, llamar a SetDefaultPrinter con un valor NULL o una cadena vacía en este parámetro podría cambiar la impresora predeterminada.
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
Al usar este método, debe especificar una impresora, un controlador y un puerto válidos. Si no son válidos, las API no producen un error, pero el resultado no se define. Esto podría hacer que otros programas vuelvan a establecer la impresora en la impresora válida anterior. Puede usar EnumPrinters para recuperar el nombre de la impresora, el nombre del controlador y el nombre del puerto de todas las impresoras disponibles.
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.
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 |
SetDefaultPrinterW (Unicode) y SetDefaultPrinterA (ANSI) |