Compartir a través de


Función DeletePrintProcessor

La función DeletePrintProcessor quita un procesador de impresión agregado por la función AddPrintProcessor .

Sintaxis

BOOL DeletePrintProcessor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pPrintProcessorName
);

Parámetros

pName [in]

Puntero a una cadena terminada en null que especifica el nombre del servidor desde el que se va a quitar el procesador. Si este parámetro es NULL, el procesador de impresora se quita localmente.

pEnvironment [in]

Puntero a una cadena terminada en null que especifica el entorno desde el que se va a quitar el procesador (por ejemplo, Windows NT x86, Windows IA64 o Windows x64). Si este parámetro es NULL, el procesador se quita del entorno actual de la aplicación que realiza la llamada y la máquina cliente (no de la aplicación de destino ni del servidor de impresión). NULL es el valor recomendado, ya que proporciona la portabilidad máxima.

pPrintProcessorName [in]

Puntero a una cadena terminada en null que especifica el nombre del procesador que se va a quitar.

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.

El autor de la llamada debe tener SeLoadDriverPrivilege.

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
DeletePrintProcessorW (Unicode) y DeletePrintProcessorA (ANSI)

Consulte también

Impresión

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

AddPrintProcessor