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