Método IPrintTicketProvider2::ConvertDevModeToPrintTicket (prdrvcom.h)
O método IPrintTicketProvider2::ConvertDevModeToPrintTicket converte uma estrutura de DEVMODEW em um tíquete de impressão.
Sintaxe
HRESULT ConvertDevModeToPrintTicket(
[in] IN ULONG cbDevmode,
[in] IN PDEVMODE pDevmode,
[in] IN IXMLDOMDocument2 *pPrintTicket
);
Parâmetros
[in] cbDevmode
O tamanho, em bytes, da estrutura de de DEVMODEW de entrada. O tamanho inclui as partes pública e privada dessa estrutura.
[in] pDevmode
Um ponteiro para a estrutura de de DEVMODEW de entrada, incluindo suas partes públicas e privadas.
[in] pPrintTicket
Um ponteiro para o tíquete de impressão parcialmente concluído. Quando IPrintTicketProvider2::ConvertDevModeToPrintTicket retorna, todas as entradas no tíquete de impressão devem ser preenchidas.
Valor de retorno
IPrintTicketProvider2::ConvertDevModeToPrintTicket deverá retornar S_OK se a operação for bem-sucedida. Caso contrário, esse método deve retornar um código de erro COM padrão.
Observações
Quando o sistema de impressão converte o conteúdo de uma estrutura de DEVMODEW em um tíquete de impressão, ele converte todos os campos de DEVMODEW públicos, exceto aqueles indicados pelo provedor de plug-in. Para esses deVMODEW campos desabilitados e não convertidos, o provedor de plug-in é responsável por preencher os valores correspondentes do tíquete de impressão. Se o DEVMODEW instantâneo tiver sido desabilitado durante uma chamada para IPrintTicketProvider2::BindPrinter, a representação da conversão deverá fornecer informações suficientes para reconstruir a estrutura de DEVMODEW original do tíquete de impressão sem perda de informações.
O instantâneo DEVMODEW permite suporte para distinções sutis em opções fornecidas na estrutura de DEVMODEW para a qual o tíquete de impressão pode não ter representações. Por exemplo, DEVMODEW podem dar suporte ao tamanho do papel LETTER, enquanto o tíquete de impressão dá suporte ao tamanho do papel LETTERSMALL.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | prdrvcom.h (inclua Prdrvcom.h) |