Función GetPrinterDriverPackagePath

Recupera la ruta de acceso al paquete de controladores de impresora especificado en un servidor de impresión.

Sintaxis

HRESULT GetPrinterDriverPackagePath(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszEnvironment,
  _In_    LPCTSTR pszLanguage,
  _In_    LPCTSTR pszPackageID,
  _Inout_ LPTSTR  pszDriverPackageCab,
  _In_    DWORD   cchDriverPackageCab,
  _Out_   LPDWORD pcchRequiredSize
);

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.

pszLanguage [in]

Puntero a una cadena constante terminada en NULL que especifica el idioma de la interfaz de usuario multilingüe para el controlador que se va a instalar. Puede ser NULL.

pszPackageID [in]

Puntero a una cadena constante terminada en NULL que especifica el identificador del paquete de controladores.

pszDriverPackageCab [in, out]

Puntero a una cadena terminada en null que especifica la ruta de acceso al archivo de archivador para el paquete de controladores. Puede ser NULL. Vea la sección Comentarios.

cchDriverPackageCab [in]

Tamaño, en caracteres, del búfer pszDriverPackageCab . Puede ser NULL.

pcchRequiredSize [out]

Puntero al tamaño necesario del búfer pszDriverPackageCab .

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.

Para obtener un valor para cchDriverPackageCab, llame a la función con NULL como valor de pszDriverPackageCab. Use el valor devuelto en pcchRequiredSize como valor de cchDriverPackageCab y vuelva a llamar a la función.

El pszPackageID se obtiene normalmente de una llamada a GetCorePrinterDrivers.

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	GetPrinterDriverPackagePathW (Unicode) y GetPrinterDriverPackagePathA (ANSI)

Consulte también

Impresión

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