Función AddPrinterConnection
La función AddPrinterConnection agrega una conexión a la impresora especificada para el usuario actual.
Sintaxis
BOOL AddPrinterConnection(
_In_ LPTSTR pName
);
Parámetros
-
pName [in]
-
Puntero a una cadena terminada en null que especifica el nombre de una impresora a la que el usuario actual desea establecer una conexión.
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.
Cuando Windows realiza una conexión a una impresora, es posible que tenga que copiar los archivos del controlador de impresora en el servidor al que está conectada la impresora. Si el usuario no tiene permiso para copiar archivos en la ubicación adecuada, se produce un error en la función AddPrinterConnection y GetLastError devuelve ERROR_ACCESS_DENIED.
Se enumerará una conexión de impresora establecida mediante una llamada a AddPrinterConnection cuando se llame a EnumPrinters con dwType establecido en PRINTER_ENUM_CONNECTION.
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 |
AddPrinterConnectionW (Unicode) y AddPrinterConnectionA (ANSI) |