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 |
|