Función GetDefaultPrinter
La función GetDefaultPrinter recupera el nombre de la impresora predeterminada para el usuario actual en el equipo local.
Sintaxis
BOOL GetDefaultPrinter(
_In_ LPTSTR pszBuffer,
_Inout_ LPDWORD pcchBuffer
);
Parámetros
-
pszBuffer [in]
-
Puntero a un búfer que recibe una cadena de caracteres terminada en null que contiene el nombre predeterminado de la impresora. Si este parámetro es NULL, se produce un error en la función y la variable a la que apunta pcchBuffer devuelve el tamaño de búfer necesario, en caracteres.
-
pcchBuffer [in, out]
-
En la entrada, especifica el tamaño, en caracteres, del búfer pszBuffer . En la salida, recibe el tamaño, en caracteres, de la cadena de nombre de la impresora, incluido el carácter nulo de terminación.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero y la variable a la que apunta pcchBuffer contiene el número de caracteres copiados en el búfer pszBuffer , incluido el carácter nulo de terminación.
Si la función no se realiza correctamente, el valor devuelto es cero.
| Valor | Significado |
|---|---|
| ERROR_INSUFFICIENT_BUFFER | El búfer pszBuffer es demasiado pequeño. La variable a la que apunta pcchBuffer contiene el tamaño de búfer necesario, en caracteres. |
| ERROR_FILE_NOT_FOUND | No hay ninguna impresora predeterminada. |
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.
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 |
GetDefaultPrinterW (Unicode) y GetDefaultPrinterA (ANSI) |