Método IPrintCoreUI2::D rvUpdateUISetting (prcomoem.h)

Artigo
02/07/2025

O método IPrintCoreUI2::DrvUpdateUISetting é fornecido pelo driver Pscript5 do Windows XP para que os plug-ins de interface do usuário Pscript5 possam notificar o driver de uma opção de interface do usuário modificada.

Sintaxe

HRESULT DrvUpdateUISetting(
  PVOID pci,
  PVOID pOptItem,
  DWORD dwPreviousSelection,
  DWORD dwMode
);

Parâmetros

pci

Ponteiro fornecido pelo chamador para uma estrutura de OEMUIOBJ.

pOptItem

Ponteiro fornecido pelo chamador para uma estrutura OPTITEM que descreve um item de opção de interface do usuário.

dwPreviousSelection

Não usado.

dwMode

Constante de inteiro fornecida pelo chamador indicando a qual página da folha de propriedades o item de opção fornecido pertence. As constantes a seguir são válidas.

Valor	Definição
OEMCUIP_DOCPROP	O item de opção fornecido pertence à página Avançado da folha de propriedades do documento.
OEMCUIP_PRNPROP	O item de opção fornecido pertence à página Configurações do Dispositivo da folha de propriedades da impressora.
OEMCUIP_PRNPROP	O item de opção fornecido pertence à página Configurações do Dispositivo da folha de propriedades da impressora.

Valor de retorno

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

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

Esse método é herdado do de interface COM IPrintOemDriverUI e pode ser chamado apenas por plug-ins de interface do usuário do Windows XP Pscript5 que não substituem totalmente as páginas de interface do usuário padrão do driver principal, e tem suporte durante o IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets funções e suas rotinas de retorno de chamada da folha de propriedades. Quando esse método tem suporte, ele tem o mesmo comportamento que IPrintOemDriverUI::D rvUpdateUISetting. Quando não há suporte, esse método deve retornar E_NOTIMPL.