Compartilhar via


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

O IPrintCoreUI2::SetOptions método define as configurações de recurso do driver.

Sintaxe

HRESULT SetOptions(
  [in]  POEMUIOBJ poemuiobj,
  [in]  DWORD     dwFlags,
  [in]  PCZZSTR   pmszFeatureOptionBuf,
  [in]  DWORD     cbIn,
  [out] PDWORD    pdwResult
);

Parâmetros

[in] poemuiobj

Ponteiro para o contexto atual, uma estrutura OEMUIOBJ .

[in] dwFlags

Especifica se o driver principal deve resolve conflitos. Esse parâmetro deve ser definido como um dos seguintes valores:

Valor Significado
SETOPTIONS_FLAG_KEEP_CONFLICT Peça ao driver principal para não resolve nenhum conflito que surja.
SETOPTIONS_FLAG_RESOLVE_CONFLICT Peça ao driver principal para resolve qualquer conflito que surja.

[in] pmszFeatureOptionBuf

Ponteiro para um buffer fornecido pelo chamador que contém uma lista de pares de recursos/opções palavra-chave no formato MULTI_SZ. Cada item nessa lista é separado do próximo por um caractere nulo e a lista é encerrada com dois caracteres nulos.

[in] cbIn

Especifica o tamanho, em bytes, do buffer apontado por pmszFeatureOptionBuf. Esse tamanho inclui o último MULTI_SZ caractere nulo.

[out] pdwResult

Ponteiro para um local de memória que recebe um dos valores a seguir. Essas constantes são definidas em printoem.h.

Valor Significado
SETOPTIONS_RESULT_CONFLICT_REMAINED O driver principal encontrou conflitos, mas os deixou não resolvidos.
SETOPTIONS_RESULT_CONFLICT_RESOLVED O driver principal encontrou e resolveu todos os conflitos.
SETOPTIONS_RESULT_NO_CONFLICT O driver principal não encontrou nenhum conflito.

Retornar valor

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_NOTIMPL
O método não tem suporte.

Não há suporte para uma estrutura do tipo especificado por dwLevel .

E_INVALIDARG
O valor em dwFlags estava incorreto.

O buffer de entrada (apontado por pmszFeatureOptionBuf) não estava no formato MULTI_SZ.

O parâmetro poemuiobj apontou para um objeto de contexto inválido.

E_FAIL
O método falhou

Comentários

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

Esse método é chamado para definir as configurações de recurso do driver usando uma lista de pares de recursos/opções palavra-chave. O chamador pode acessar as configurações de recurso resultantes usando o método IPrintCoreUI2::GetOptions .

Se esse método retornar qualquer valor diferente de S_OK, ele não fez nenhuma alteração nas configurações de recurso do driver.

O buffer de entrada pmszFeatureOptionBuf deve ser construído da mesma forma que o buffer de saída do método IPrintCoreUI2::GetOptions . Ou seja, o recurso/opção palavra-chave pares devem estar no formato MULTI_SZ e cada item na lista é separado do próximo por um caractere nulo. Um par de caracteres nulos encerra a lista.

Se o buffer de entrada contiver um recurso palavra-chave ou sua opção palavra-chave que não é reconhecido ou se o recurso for reconhecido, mas não tiver suporte no modo autoadesivo atual (consulte Substituindo Driver-Supplied páginas de folha de propriedades), o par recurso/opção será ignorado e a opção atual para esse recurso continuará em vigor.

Esse método tem suporte apenas para plug-ins de interface do usuário que substituem totalmente as páginas de interface do usuário padrão do driver principal e só tem suporte durante as funções IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets e suas rotinas de retorno de chamada da folha de propriedades.

Para obter mais informações, consulte Usando GetOptions e SetOptions.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintCoreUI2

IPrintCoreUI2::GetOptions

IPrintOemUI::D evicePropertySheets

IPrintOemUI::D ocumentPropertySheets

OEMUIOBJ