Método IPrintTicketProvider::ConvertDevModeToPrintTicket (prdrvcom.h)

O método IPrintTicketProvider::ConvertDevModeToPrintTicket converte uma estrutura 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 DEVMODEW de entrada. O tamanho inclui as partes pública e privada dessa estrutura.

[in] pDevmode

Um ponteiro para a estrutura 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 IPrintTicketProvider::ConvertDevModeToPrintTicket retornar, todas as entradas no tíquete de impressão deverão ser preenchidas.

Retornar valor

IPrintTicketProvider::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.

Comentários

Quando o sistema de impressão converte o conteúdo de uma estrutura DEVMODEW em um tíquete de impressão, ele converte todos os campos de DEVMODEW públicos, exceto aqueles que o provedor de plug-in indicou que devem ser desabilitados. Para esses campos DEVMODEW desabilitados e não convertidos, o provedor de plug-in é responsável por preencher os valores de tíquete de impressão correspondentes. Se o instantâneo DEVMODEW tiver sido desabilitado durante uma chamada para IPrintTicketProvider::BindPrinter, a representação da conversão deverá fornecer informações suficientes para reconstruir a estrutura 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 DEVMODEW para as quais o tíquete de impressão pode não ter representações. Por exemplo, DEVMODEW pode 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)

Confira também

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode