Leer en inglés

Compartir a través de


Función MergeAndValidatePrintTicketThunk2

[Esta función no se admite y puede deshabilitarse o eliminarse en versiones futuras de Windows. PTMergeAndValidatePrintTicket proporciona una funcionalidad equivalente y debe usarse en su lugar.]

Combina dos vales de impresión y devuelve un vale de impresión válido y viable.

Sintaxis

HRESULT MergeAndValidatePrintTicketThunk2(
  _In_      HPTPROVIDER hProvider,
  _In_      BYTE        *pBasePrintTicket,
  _In_      INT         basePrintTicketLength,
  _In_opt_  BYTE        *pDeltaPrintTicket,
  _In_      INT         deltaPrintTicketLength,
  _In_      DWORD       scope,
  _Out_     BYTE        **ppValidatedPrintTicket,
  _Out_     INT         *pValidatedPrintTicketLength,
  _Out_opt_ BSTR        *pbstrErrorMessage
);

Parámetros

hProvider [in]

Identificador de un proveedor de vales de impresión abierto. La función BindPTProviderThunk devuelve este identificador.

pBasePrintTicket [in]

Búfer que contiene los datos del vale de impresión base, expresados en XML como se describe en el esquema de impresión.

basePrintTicketLength [in]

Tamaño, en bytes, del búfer al que hace referencia pBasePrintTicket.

pDeltaPrintTicket [in, optional]

Búfer que contiene el vale de impresión que se va a combinar. Los datos del vale de impresión se expresan en XML como se describe en el esquema de impresión. El valor de este parámetro puede ser NULL.

deltaPrintTicketLength [in]

Tamaño, en bytes, del búfer al que hace referencia pDeltaPrintTicket.

ámbito [in]

Valor que especifica si el ámbito de pDeltaPrintTicket y ppValidatedPrintTicket es una sola página, un documento completo o todos los documentos del trabajo de impresión. El valor de este parámetro debe ser miembro de la enumeración EPrintTicketScope , que se convierte como DWORD.

ppValidatedPrintTicket [out]

Dirección del búfer que contiene el vale de impresión combinado y validado. Esta función llama a CoTaskMemAlloc para asignar este búfer. Cuando el búfer ya no es necesario, el autor de la llamada debe liberarlo llamando a CoTaskMemFree.

pValidatedPrintTicketLength [out]

Tamaño, en bytes, del búfer al que hace referencia ppValidatedPrintTicket.

pbstrErrorMessage [out, optional]

Puntero a una cadena que especifica qué, si hay algo, no es válido sobre el vale de impresión en pBasePrintTicket o pDeltaPrintTicket. Si ambos son válidos, este valor es NULL. Si pbstrErrorMessage no es NULL cuando la función devuelve, el autor de la llamada debe liberar la cadena con SysFreeString.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT . Para obtener más información sobre los códigos de error COM, vea Control de errores.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL
Prntvpt.dll

Consulte también

Esquema de impresión

PTMergeAndValidatePrintTicket

Impresión

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