勇芳软件工作室.汉化:  Printing > Print Ticket API > Print Ticket API Functions >

PTConvertDevModeToPrintTicket (XP)

Previous pageReturn to chapter overviewNext page

描述

 

DEVMODE结构转换为IStream内的打印票据。

 

C++ 语法

 

HRESULT PTConvertDevModeToPrintTicket(

__in HPTPROVIDER hProvider,

__in ULONG cbDevmode,

__in PDEVMODE pDevmode,

__in EPrintTicketScope scope,

__in IStream *pPrintTicket

);

 

PowerBASIC 语法

 

FUNCTION PTConvertDevModeToPrintTicket ( _

BYVAL hProvider AS DWORD, _

BYVAL cbDevmode AS DWORD, _

BYREF pDevmode AS DEVMODEA, _

BYVAL scope AS DWORD, _

BYVAL pPrintTicket AS IStream _

) AS LONG

 

参数

 

hProvider

 

[in]打开打印机票提供者的句柄。该句柄由PTOpenProviderPTOpenProviderEx函数返回。

 

cbDevmode

 

[in]DEVMODE的大小(以字节为单位)。

 

pDevmode

 

[in]指向DEVMODE的指针。

 

scope

 

[in]指定pPrintTicket范围的值。该值可以指定单页,整个文档或打印作业中的所有文档。pDevmodeel-Latn中超出指定范围的设置将不会包含在pPrintTicket中。见备注.

 

pPrintTicket

 

[in]指向IStream的指针,其搜索位置位于打印机票的开头。

 

返回值

 

如果操作成功,则返回值为S_OK,否则HRESULT包含错误代码。

 

如果hProvider在另一个线程中打开,则HRESULT是E_INVALIDARG。

 

备注

 

hProvider必须是在与用于此函数的线程相同的线程中打开的句柄。

 

如果pDevmodeel-Latn指向不同的打印机,其设置可能会丢失,并以默认值替换。

 

不在范围内的pDevmodeel-Latn中的设置不包含在pPrintTicket中。例如,如果范围是单个页面,则不包括作业范围设置和文档范围设置。作业范围包括文档范围和页面范围。文档范围包括页面范围。

 

PTConvertDevModeToPrintTicket将打印票据写入由pPrintTicket引用的IStream,从流的当前查找点开始。在PTConvertDevModeToPrintTicket返回后,呼叫者必须将搜索点重置到初始搜索点以读取该函数返回的打印机票。

 

引用文件 #INCLUDE Once

 

Prntvpt.inc