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

Artículo
08/07/2023

El IPrintCoreUI2::SetOptions método establece la configuración de características del controlador.

Sintaxis

HRESULT SetOptions(
  [in]  POEMUIOBJ poemuiobj,
  [in]  DWORD     dwFlags,
  [in]  PCZZSTR   pmszFeatureOptionBuf,
  [in]  DWORD     cbIn,
  [out] PDWORD    pdwResult
);

Parámetros

[in] poemuiobj

Puntero al contexto actual, una estructura OEMUIOBJ .

[in] dwFlags

Especifica si el controlador principal es resolver conflictos. Este parámetro debe establecerse en uno de los valores siguientes:

Valor	Significado
SETOPTIONS_FLAG_KEEP_CONFLICT	Pida al controlador principal que no resuelva ningún conflicto que surja.
SETOPTIONS_FLAG_RESOLVE_CONFLICT	Pida al controlador principal que resuelva cualquier conflicto que surja.

[in] pmszFeatureOptionBuf

Puntero a un búfer proporcionado por el autor de la llamada que contiene una lista de pares de palabras clave de característica y opción en MULTI_SZ formato. Cada elemento de esta lista está separado del siguiente por un carácter nulo y la lista finaliza con dos caracteres NULL.

[in] cbIn

Especifica el tamaño, en bytes, del búfer al que apunta pmszFeatureOptionBuf. Este tamaño incluye el último carácter nulo MULTI_SZ.

[out] pdwResult

Puntero a una ubicación de memoria que recibe uno de los valores siguientes. Estas constantes se definen en printoem.h.

Valor	Significado
SETOPTIONS_RESULT_CONFLICT_REMAINED	El controlador principal encontró conflictos, pero los ha dejado sin resolver.
SETOPTIONS_RESULT_CONFLICT_RESOLVED	El controlador principal encontró y resolvió todos los conflictos.
SETOPTIONS_RESULT_NO_CONFLICT	El controlador principal no encontró ningún conflicto.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_NOTIMPL	El método no se admite. No se admite una estructura del tipo especificado por dwLevel .
E_INVALIDARG	El valor de dwFlags era incorrecto. El búfer de entrada (al que apunta pmszFeatureOptionBuf) no estaba en formato MULTI_SZ. El parámetro poemuiobj apuntaba a un objeto de contexto no válido.
E_FAIL	Error en el método

Comentarios

Este método solo se admite para complementos Pscript5 de Windows XP, no para complementos Unidrv.

Se llama a este método para establecer la configuración de características del controlador mediante una lista de pares de palabras clave feature/option. El autor de la llamada puede acceder a la configuración de características resultante mediante el método IPrintCoreUI2::GetOptions .

Si este método devuelve cualquier valor distinto de S_OK, no realizó ningún cambio en la configuración de la característica del controlador.

El búfer de entrada pmszFeatureOptionBuf debe construirse de la misma manera que el búfer de salida del método IPrintCoreUI2::GetOptions . Es decir, los pares de palabras clave feature/option deben estar en formato MULTI_SZ y cada elemento de la lista está separado del siguiente por un carácter nulo. Un par de caracteres nulos finaliza la lista.

Si el búfer de entrada contiene una palabra clave de característica o su palabra clave de opción que no se reconoce, o se reconoce la característica pero no se admite en el modo permanente actual (consulte Reemplazar Driver-Supplied páginas de hoja de propiedades), se omite el par de características y opciones y la opción actual de esa característica sigue en vigor.

Este método solo se admite para complementos de interfaz de usuario que reemplazan completamente las páginas de interfaz de usuario estándar del controlador principal y solo se admiten durante las funciones IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets y sus rutinas de devolución de llamada de hoja de propiedades.

Para obtener más información, vea Uso de GetOptions y SetOptions.