Função ConvertPrintTicketToDevModeThunk2

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

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

Sintaxe

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
);

Parâmetros

hProvider [in]

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

pPrintTicket [in]

O buffer que contém o tíquete de impressão a ser convertido.

cbSize [in]

O tamanho, em bytes, do buffer passado em pPrintTicket.

baseType [in]

Um valor que indica se o DEVMODE padrão do usuário ou o DEVMODE padrão da fila de impressão é usado para fornecer valores ao DEVMODE de saída quando pPrintTicket não especifica todas as configurações possíveis para um DEVMODE. O valor desse parâmetro deve ser um membro da enumeração EDefaultDevmodeType , convertido como um INT.

escopo [in]

Um valor que especifica o escopo de pPrintTicket. 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.

ppDevmode [out]

O endereço do DEVMODE recém-criado. 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.

pcbDevModeLength [out]

O tamanho, em bytes, do DEVMODE retornado em ppDevmode.

errMsg [out, opcional]

Um ponteiro para uma cadeia de caracteres que especifica o que, se alguma coisa, é inválido sobre o tíquete de impressão em pPrintTicket. Se for válido, será NULL. Se errMsg não for NULL quando a função retornar, o chamador deverá liberar a cadeia de caracteres com SysFreeString.

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará 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

PTConvertPrintTicketToDevMode

Impressão

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