Método IPrintCoreUI2::SetOptions (prcomoem.h)
O método IPrintCoreUI2::SetOptions 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 de OEMUIOBJ.
[in] dwFlags
Especifica se o driver principal deve resolver 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 resolver nenhum conflito que surja. |
| SETOPTIONS_FLAG_RESOLVE_CONFLICT | Peça ao driver principal para resolver qualquer conflito que surja. |
[in] pmszFeatureOptionBuf
Ponteiro para um buffer fornecido pelo chamador que contém uma lista de pares de palavras-chave de recurso/opção 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 a última 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. |
Valor de retorno
O método deve retornar um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Não há suporte para o método.
Não há suporte para uma estrutura do tipo especificada por dwLevel. |
|
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. |
|
Falha no método |
Observações
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 palavras-chave de recurso/opção. 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 de. Ou seja, os pares de palavra-chave de recurso/opção devem estar no formato MULTI_SZ e cada item da lista é separado do próximo por um caractere nulo. Um par de caracteres nulos encerra a lista.
Se o buffer de entrada contiver uma palavra-chave de recurso ou sua palavra-chave de opção que não é reconhecida ou se o recurso for reconhecido, mas não tiver suporte no modo autoadesivo atual (consulte Substituindo Driver-Supplied Páginas da Folha de Propriedades), o par recurso/opção será ignorado e a opção atual desse recurso continuará em vigor.
Esse método só tem suporte 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 o IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets funções e suas rotinas de retorno de chamada da folha de propriedades.
Para obter mais informações, consulte Usando GetOptions e SetOptions.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |
Consulte também
IPrintOemUI::D evicePropertySheets