Compartir a través de

Función PTConvertDevModeToPrintTicket (prntvpt.h)

  • Artículo

Convierte una estructura DEVMODE en un vale de impresión dentro de un IStream.

Sintaxis

HRESULT PTConvertDevModeToPrintTicket(
  [in] HPTPROVIDER       hProvider,
       ULONG             cbDevmode,
  [in] PDEVMODE          pDevmode,
  [in] EPrintTicketScope scope,
       IStream           *pPrintTicket
);

Parámetros

[in] hProvider

Identificador de un proveedor de vales de impresión abierto. El ptopenProvider o la función PTOpenProviderEx devuelve este identificador.

cbDevmode

Tamaño del DEVMODE en bytes.

[in] pDevmode

Puntero al DEVMODE.

[in] scope

Valor que especifica el ámbito de pPrintTicket. Este valor puede especificar una sola página, un documento completo o todos los documentos del trabajo de impresión. La configuración de pDevmode que está fuera del ámbito especificado no se incluirá en pPrintTicket. Vea la sección Comentarios.

pPrintTicket

Puntero a un IStream con su posición de búsqueda al principio del vale 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.

Si hProvider se abrió en un subproceso diferente, hrESULT se E_INVALIDARG.

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 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.
 
hProvider debe ser un identificador que se abrió en el mismo subproceso que el subproceso en el que se usa para esta función.

Si el pDevmode apunta a una impresora diferente, su configuración se puede perder y reemplazar por valores predeterminados.

La configuración de pDevmode que está fuera del ámbito no se incluye en pPrintTicket. Por ejemplo, si el ámbito es una sola página, no se incluyen la configuración de todo el trabajo y la configuración de todo el documento. Un ámbito de trabajo incluye ámbito de documento y ámbito de página. Un ámbito de documento incluye el ámbito de página.

PTConvertDevModeToPrintTicket escribe el vale de impresión en el IStream al que hace referencia pPrintTicket a partir del punto de búsqueda actual de la secuencia. Después de que PTConvertDevModeToPrintTicket devuelva, el autor de la llamada debe restablecer el punto de búsqueda inicial al punto de búsqueda inicial para leer el vale de impresión devuelto por la función .

Requisitos

   
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