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

  • Artigo

O IPrintOemDriverUI::DrvUpdateUISetting método é fornecido pelos minidrivers Unidrv e Pscript5 para que os plug-ins de interface do usuário 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 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 de 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.
 

Para obter mais informações, consulte a seção Comentários a seguir.

Retornar valor

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

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_FAIL
 Falha na operação.
E_NOTIMPL
 O método não está implementado.

Comentários

Se você estiver fornecendo um plug-in de interface do usuário que implementa o método IPrintOemUI::D ocumentPropertySheets ou o método IPrintOemUI::D evicePropertySheets , normalmente você também fornece uma função de retorno de chamada do tipo _CPSUICALLBACK para lidar com modificações do usuário. Essa função de retorno de chamada deve chamar IPrintOemDriverUI::DrvUpdateUISetting para informar o driver quando o valor associado a uma configuração de interface do usuário tiver sido modificado, se o valor for armazenado na estrutura DEVMODEW do driver (em vez dos membros de DEVMODEW privados do plug-in) ou em chaves do Registro.

O valor especificado para dwMode deve ser baseado em qual método especificou a função de retorno de chamada.

Requisitos

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