Función InstallPrinterDriverFromPackage

Instala un controlador de impresora desde un paquete de controladores que se encuentra en el almacén de controladores del servidor de impresión.

Sintaxis

HRESULT InstallPrinterDriverFromPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszDriverName,
  _In_ LPCTSTR pszEnvironment,
  _In_ DWORD   dwFlags
);

Parámetros

pszServer [in]

Puntero a una cadena constante terminada en null que especifica el nombre del servidor de impresión. NULL significa el equipo local.

pszInfPath [in]

Puntero a una cadena constante terminada en null que especifica la ruta de acceso del almacén del controlador al archivo .inf del controlador de impresión. NULL significa que el controlador está en un archivo inf que se incluye con Windows.

pszDriverName [in]

Puntero a una cadena constante terminada en null que especifica el nombre del controlador.

pszEnvironment [in]

Puntero a una cadena constante terminada en null que especifica la arquitectura del procesador (por ejemplo, Windows NT x86). Puede ser NULL.

dwFlags [in]

Solo puede ser 0 o IPDFP_COPY_ALL_FILES. Un valor de 0 significa que se debe agregar el controlador de impresora y se deben copiar los archivos del directorio del controlador de impresora que sean más recientes que los archivos correspondientes actualmente en uso. Un valor de IPDFP_COPY_ALL_FILES significa que se debe agregar el controlador de impresora y todos los archivos del directorio del controlador de impresora. Las marcas de tiempo del archivo se omiten cuando dwFlags tiene un valor de IPDFP_COPY_ALL_FILES.

Valor devuelto

Si la operación se realiza correctamente, el valor devuelto es S_OK; de lo contrario, HRESULT contendrá un código de error.

Para obtener más información sobre los códigos de error COM, vea Control de errores.

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 almacén de controladores suele ser %windir%\inf o %windir%\System32\DriverStore\FileRepository.

InstallPrinterDriverFromPackage también instala otros archivos en el paquete, como perfiles de color y procesadores de impresión.

Los usuarios deben tener derechos de administración de impresoras para instalar en un equipo remoto o en el equipo local cuando el usuario haya iniciado sesión con Terminal Services.

Solo se pueden instalar paquetes firmados en un equipo remoto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Winspool.h (incluye Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Spoolss.dll
Nombres Unicode y ANSI	InstallPrinterDriverFromPackageW (Unicode) e InstallPrinterDriverFromPackageA (ANSI)

Consulte también

Impresión

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