Compartir a través de

Función PTOpenProvider (prntvpt.h)

  • Artículo

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

Sintaxis

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

Parámetros

[in] pszPrinterName

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

dwVersion

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

[out] phProvider

Puntero a un identificador para el proveedor.

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.
 
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. Esta operación produce un error si no se admite la versión . Compare esto con PTOpenProviderEx , que abre un proveedor aunque solo admita versiones anteriores a las solicitadas.

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