Compartilhar via


Função ConvertDevModeToPrintTicketThunk2

[Essa função não tem suporte e pode ser desabilitada ou excluída em versões futuras do Windows. PTConvertDevModeToPrintTicket fornece funcionalidade equivalente e deve ser usado em vez disso.]

Converte uma estrutura DEVMODE em um tíquete de impressão.

Sintaxe

HRESULT ConvertDevModeToPrintTicketThunk2(
  _In_  HPTPROVIDER hProvider,
  _In_  BYTE        *pDevmode,
  _In_  ULONG       cbSize,
  _In_  DWORD       scope,
  _Out_ BYTE        **ppPrintTicket,
  _Out_ INT         *pcbPrintTicketLength
);

Parâmetros

hProvider [in]

Um identificador para um provedor de tíquete de impressão aberto. Esse identificador é retornado pela função BindPTProviderThunk .

pDevmode [in]

Um ponteiro para o DEVMODE a ser convertido.

cbSize [in]

O tamanho, em bytes, do DEVMODE passado em pDevmode.

escopo [in]

Um valor que especifica o escopo de ppPrintTicket. Esse valor pode especificar uma única página, um documento inteiro ou todos os documentos no trabalho de impressão. O valor desse parâmetro deve ser um membro da enumeração EPrintTicketScope , convertido como um DWORD.

ppPrintTicket [out]

O endereço do buffer que contém um tíquete de impressão que representa o DEVMODE passado em pDevmode. Essa função chama CoTaskMemAlloc para alocar esse buffer. Quando o buffer não for mais necessário, o chamador deverá liberá-lo chamando CoTaskMemFree.

pcbPrintTicketLength [out]

O tamanho, em bytes, do tíquete de impressão retornado em ppPrintTicket.

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retorna um código de erro HRESULT . Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
DLL
Prntvpt.dll

Confira também

Esquema de Impressão

PTConvertDevModeToPrintTicket

Impressão

Funções da API do Spooler de impressão