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

Artigo
08/07/2023

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.