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

Artigo
02/07/2025

O método IPrintOemDriverUI::DrvUpdateUISetting é 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 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.

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

Valor de retorno

O 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

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, você normalmente também fornece uma função de retorno de chamada _CPSUICALLBACKtipada para lidar com as 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 de de DEVMODEW do driver (em vez dos membros 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
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Partilhar via