Compartir a través de


Función DeletePrinterConnection

La función DeletePrinterConnection elimina una conexión a una impresora que se estableció mediante una llamada a AddPrinterConnection o ConnectToPrinterDlg.

Sintaxis

BOOL DeletePrinterConnection(
  _In_ LPTSTR pName
);

Parámetros

pName [in]

Puntero a una cadena terminada en null que especifica el nombre de la conexión de impresora que se va a eliminar.

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.

La función DeletePrinterConnection no elimina los archivos de controlador de impresora que se copiaron en el servidor al que está conectada la impresora.

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
Winspool.drv
Nombres Unicode y ANSI
DeletePrinterConnectionW (Unicode) y DeletePrinterConnectionA (ANSI)

Consulte también

Impresión

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

AddPrinterConnection

AddPrinterConnection2

ConnectToPrinterDlg