Función GetCorePrinterDrivers

Recupera el GUID, la versión y la fecha de los controladores de impresora principales especificados y la ruta de acceso a sus paquetes.

Sintaxis

HRESULT GetCorePrinterDrivers(
  _In_  LPCTSTR              pszServer,
  _In_  LPCTSTR              pszEnvironment,
  _In_  LPCTSTR              pszzCoreDriverDependencies,
  _In_  DWORD                cCorePrinterDrivers,
  _Out_ PCORE_PRINTER_DRIVER pCorePrinterDrivers
);

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.

pszzCoreDriverDependencies [in]

Puntero a una cadena múltiple terminada en null que especifica los GUID de los controladores de impresora principales.

cCorePrinterDrivers [in]

Número de cadenas en pszzCoreDriverDependencies.

pCorePrinterDrivers [out]

Puntero a una matriz de una o varias estructuras CORE_PRINTER_DRIVER .

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

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	GetCorePrinterDriversW (Unicode) y GetCorePrinterDriversA (ANSI)

Consulte también

Impresión

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