Função MergeAndValidatePrintTicketThunk2

[Essa função não tem suporte e pode ser desabilitada ou excluída em versões futuras do Windows. PTMergeAndValidatePrintTicket fornece funcionalidade equivalente e deve ser usado em vez disso.]

Mescla dois tíquetes de impressão e retorna um tíquete de impressão válido e viável.

Sintaxe

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]

Um identificador para um provedor de tíquete de impressão aberto. Esse identificador é retornado pela função BindPTProviderThunk .

pBasePrintTicket [in]

O buffer que contém os dados do tíquete de impressão base, expressos em XML, conforme descrito no Esquema de Impressão.

basePrintTicketLength [in]

O tamanho, em bytes, do buffer referenciado por pBasePrintTicket.

pDeltaPrintTicket [in, opcional]

O buffer que contém o tíquete de impressão a ser mesclado. Os dados do tíquete de impressão são expressos em XML, conforme descrito no Esquema de Impressão. O valor desse parâmetro pode ser NULL.

deltaPrintTicketLength [in]

O tamanho, em bytes, do buffer referenciado por pDeltaPrintTicket.

escopo [in]

O valor que especifica se o escopo de pDeltaPrintTicket e ppValidatedPrintTicket é uma única página, um documento inteiro ou todos os documentos no trabalho de impressão. O valor desse parâmetro deve ser um membro da enumeração EPrintTicketScope , convertido como um DWORD.

ppValidatedPrintTicket [out]

O endereço do buffer que contém o tíquete de impressão mesclado e validado. Essa função chama CoTaskMemAlloc para alocar esse buffer. Quando o buffer não for mais necessário, o chamador deverá liberá-lo chamando CoTaskMemFree.

pValidatedPrintTicketLength [out]

O tamanho, em bytes, do buffer referenciado por ppValidatedPrintTicket.

pbstrErrorMessage [out, opcional]

Um ponteiro para uma cadeia de caracteres que especifica o que, se alguma coisa, é inválido sobre o tíquete de impressão em pBasePrintTicket ou pDeltaPrintTicket. Se ambos forem válidos, esse valor será NULL. Se pbstrErrorMessage não for NULL quando a função retornar, o chamador deverá liberar a cadeia de caracteres com SysFreeString.

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT . Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
DLL	Prntvpt.dll

Confira também

Esquema de Impressão

PTMergeAndValidatePrintTicket

Impressão

Funções da API do Spooler de impressão