Функция MergeAndValidatePrintTicketThunk2
[Эта функция не поддерживается и может быть отключена или удалена в будущих версиях Windows. PTMergeAndValidatePrintTicket предоставляет эквивалентные функциональные возможности и должен использоваться вместо этого.]
Объединяет два билета на печать и возвращает действительный, жизнеспособный билет.
Синтаксис
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
);
Параметры
-
hProvider [in]
-
Дескриптор для открытого поставщика билетов на печать. Этот дескриптор возвращается функцией BindPTProviderThunk .
-
pBasePrintTicket [in]
-
Буфер, содержащий базовые данные билета печати, выраженные в ФОРМАТЕ XML, как описано в схеме печати.
-
basePrintTicketLength [in]
-
Размер (в байтах) буфера, на который ссылается pBasePrintTicket.
-
pDeltaPrintTicket [in, необязательный]
-
Буфер, содержащий билет на печать для слияния. Данные билета на печать выражаются в формате XML, как описано в схеме печати. Значение этого параметра может иметь значение NULL.
-
deltaPrintTicketLength [in]
-
Размер (в байтах) буфера, на который ссылается pDeltaPrintTicket.
-
область [in]
-
Значение , указывающее, является ли область pDeltaPrintTicket и ppValidatedPrintTicket одной страницей, целым документом или всеми документами в задании печати. Значение этого параметра должно быть членом перечисления EPrintTicketScope , которое приводится как DWORD.
-
ppValidatedPrintTicket [out]
-
Адрес буфера, содержащего объединенный и проверенный билет печати. Эта функция вызывает CoTaskMemAlloc для выделения этого буфера. Если буфер больше не нужен, вызывающий объект должен освободить его, вызвав CoTaskMemFree.
-
pValidatedPrintTicketLength [out]
-
Размер (в байтах) буфера, на который ссылается ppValidatedPrintTicket.
-
pbstrErrorMessage [out, optional]
-
Указатель на строку, указывающую, что является недопустимым в билете печати в pBasePrintTicket или pDeltaPrintTicket. Если они оба являются допустимыми, это значение равно NULL. Если функция pbstrErrorMessage не имеет значение NULL , вызывающий объект должен освободить строку с помощью SysFreeString.
Возвращаемое значение
Если метод завершается успешно, он возвращает S_OK; в противном случае возвращается код ошибки HRESULT . Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| DLL |
|