Compartir a través de

Función CorePrinterDriverInstalled

  • Artículo

La función CorePrinterDriverInstalled informa de si se instala un controlador de impresora principal con un GUID, una fecha y una versión especificados.

Sintaxis

HRESULT CorePrinterDriverInstalled(
  _In_  LPCTSTR   pszServer,
  _In_  LPCTSTR   pszEnvironment,
  _In_  GUID      CoreDriverGUID,
  _In_  FILETIME  ftDriverDate,
  _In_  DWORDLONG dwlDriverVersion,
  _Out_ BOOL      *pbDriverInstalled
);

Parámetros

pszServer [in]

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

pszEnvironment [in]

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

CoreDriverGUID [in]

GUID del controlador de impresora principal.

ftDriverDate [in]

Fecha del controlador de impresora principal.

dwlDriverVersion [in]

Versión del controlador de impresora principal.

pbDriverInstalled [out]

Puntero a TRUE si el controlador, o una versión más reciente, está instalado, FALSE en caso contrario.

Valor devuelto

Si la operación se realiza correctamente, se S_OK el valor devuelto; 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 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.

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
 CorePrinterDriverInstalledW (Unicode) y CorePrinterDriverInstalledA (ANSI)

Consulte también

Impresión

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