Función PTOpenProviderEx (prntvpt.h)

Abre una instancia de un proveedor de vales de impresión.

Sintaxis

HRESULT PTOpenProviderEx(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwMaxVersion,
        DWORD       dwPrefVersion,
  [out] HPTPROVIDER *phProvider,
  [out] DWORD       *pUsedVersion
);

Parámetros

[in] pszPrinterName

Puntero al nombre completo de una cola de impresión.

dwMaxVersion

La versión más reciente del esquema de impresión que admite el autor de la llamada.

dwPrefVersion

Versión del esquema de impresión solicitado por el autor de la llamada.

[out] phProvider

Puntero a un identificador para el proveedor.

[out] pUsedVersion

Puntero a la versión del esquema de impresión que usará el proveedor de vales de impresión.

Valor devuelto

Si la operación se realiza correctamente, el valor devuelto se S_OK; de lo contrario, HRESULT contiene 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 esta función devuelve depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y la implementación del controlador de impresora, factores 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 parámetro pszPrinterName debe ser el nombre completo, no el nombre truncado, ya que puede aparecer en un DEVMODE.

La primera versión del esquema de impresión se publicó con Windows Vista y es la versión 1. Si el proveedor de vales de impresión no admite prefVersion, PTOpenProviderEx abre correctamente un identificador y devuelve una versión anterior en usedVersion.

Para evitar una fuga de recursos, phProvider debe cerrarse con PTCloseProvider.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	prntvpt.h
Library	Prntvpt.lib
Archivo DLL	Prntvpt.dll

Consulte también

Esquema de impresión

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

Impresión