Método IPrintCoreUI2::QuerySimulationSupport (prcomoem.h)

Artigo
02/07/2025

O método IPrintCoreUI2::QuerySimulationSupport recupera uma estrutura de funcionalidade de simulação do spooler, que indica os tipos de simulação compatíveis com o spooler.

Sintaxe

HRESULT QuerySimulationSupport(
  [in]  HANDLE hPrinter,
  [in]  DWORD  dwLevel,
  [out] PBYTE  pCaps,
  [in]  DWORD  cbSize,
  [out] PDWORD pcbNeeded
);

Parâmetros

[in] hPrinter

Especifica um identificador para a impressora.

[in] dwLevel

Especifica a estrutura de funcionalidade de simulação do spooler retornada no buffer apontado por pCaps. Atualmente, somente o nível 1 do suporte à simulação do spooler é fornecido.

Valor	Estrutura de suporte de simulação do Spooler
1	SIMULATE_CAPS_1 (definido em printoem.h)

[out] pCaps

Ponteiro para o buffer de saída, que contém uma estrutura do tipo indicada pelo valor no parâmetro dwLevel.

[in] cbSize

Especifica o tamanho, em bytes, do buffer de saída, que é apontado por pCaps.

[out] pcbNeeded

Especifica o tamanho, em bytes, da memória necessária para armazenar uma estrutura do tipo indicada por dwLevel.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	O valor em cbSize era menor que o número de bytes a serem gravados no buffer de saída (o buffer apontado por pCaps). O método foi chamado com pCaps definido como NULL.
E_NOTIMPL	Não há suporte para o método. Não há suporte para uma estrutura do tipo especificada por dwLevel.
E_FAIL	Falha no método

Observações

Esse método tem suporte apenas para plug-ins do Windows XP Pscript5, não para plug-ins Unidrv.

O método IPrintCoreUI2::QuerySimulationSupport armazena uma estrutura de funcionalidade de simulação de spooler no buffer apontado por pCaps. Essa estrutura especifica o nível de suporte do spooler para impressão "N-up", impressão reversa, o número máximo de páginas que podem ser impressas, ordenação e outras.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Consulte também

IPrintCoreUI2

SIMULATE_CAPS_1

Partilhar via