Función AddPrintProcessor

La función AddPrintProcessor instala un procesador de impresión en el servidor especificado y agrega el nombre del procesador de impresión a la lista de procesadores de impresión admitidos.

Sintaxis

BOOL AddPrintProcessor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pPathName,
  _In_ LPTSTR pPrintProcessorName
);

Parámetros

pName [in]

Puntero a una cadena terminada en null que especifica el nombre del servidor en el que se debe instalar el procesador de impresión. Si este parámetro es NULL, el procesador de impresión se instala localmente.

pEnvironment [in]

Puntero a una cadena terminada en null que especifica el entorno (por ejemplo, Windows x86, Windows IA64 o Windows x64). Si este parámetro es NULL, se usa el entorno actual del autor de llamada o cliente (no del destino o servidor).

pPathName [in]

Puntero a una cadena terminada en null que especifica el nombre del archivo que contiene el procesador de impresión. Este archivo debe estar en el directorio del procesador de impresión del sistema.

pPrintProcessorName [in]

Puntero a una cadena terminada en null que especifica el nombre del procesador de impresió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 y 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 de controladores 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.

Antes de llamar a la función AddPrintProcessor , una aplicación debe comprobar que el archivo que contiene el procesador de impresión se almacena en el directorio del procesador de impresión del sistema. Una aplicación puede recuperar el nombre del directorio del procesador de impresión del sistema llamando a la función GetPrintProcessorDirectory .

Una aplicación puede determinar el nombre de los procesadores de impresión existentes mediante una llamada a la función EnumPrintProcessors .

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	AddPrintProcessorW (Unicode) y AddPrintProcessorA (ANSI)

Consulte también

Impresión

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

EnumPrintProcessors

GetPrintProcessorDirectory