Функция ConvertPrintTicketToDevModeThunk2
[Эта функция не поддерживается и может быть отключена или удалена в будущих версиях Windows. PTConvertPrintTicketToDevMode предоставляет эквивалентные функциональные возможности и должен использоваться вместо этого.]
Преобразует билет на печать в структуру DEVMODE .
Синтаксис
HRESULT ConvertPrintTicketToDevModeThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ ULONG cbSize,
_In_ INT baseType,
_In_ DWORD scope,
_Out_ BYTE **ppDevmode,
_Out_ ULONG *pcbDevModeLength,
_Out_opt_ BSTR *errMsg
);
Параметры
-
hProvider [in]
-
Дескриптор для открытого поставщика билетов на печать. Этот дескриптор возвращается функцией BindPTProviderThunk .
-
pPrintTicket [in]
-
Буфер, содержащий преобразуемый билет на печать.
-
cbSize [in]
-
Размер буфера, переданного в pPrintTicket, в байтах.
-
baseType [in]
-
Значение , указывающее, используется ли devmode по умолчанию пользователя или devmode очереди печати по умолчанию для предоставления значений в выходные данные DEVMODE , если pPrintTicket не указывает все возможные параметры для DEVMODE. Значение этого параметра должно быть членом перечисления EDefaultDevmodeType , приведение к типу INT.
-
область [in]
-
Значение типа , указывающее область pPrintTicket. Это значение может указывать одну страницу, весь документ или все документы в задании печати. Значение этого параметра должно быть членом перечисления EPrintTicketScope , которое приводится как DWORD.
-
ppDevmode [out]
-
Адрес только что созданного DEVMODE. Эта функция вызывает CoTaskMemAlloc для выделения этого буфера. Если буфер больше не нужен, вызывающий объект должен освободить его, вызвав CoTaskMemFree.
-
pcbDevModeLength [out]
-
Размер в байтах DEVMODE , возвращаемого в ppDevmode.
-
errMsg [out, optional]
-
Указатель на строку, указывающую, что является недопустимым в билете печати в pPrintTicket. Если это допустимо, это значение равно NULL. Если функция errMsg не имеет значение NULL , вызывающий объект должен освободить строку с помощью SysFreeString.
Возвращаемое значение
Если метод завершается успешно, он возвращает S_OK; в противном случае возвращается код ошибки HRESULT . Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| DLL |
|