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

El método IPrintCoreHelperPS::SetOptions establece varios pares de opción de características al mismo tiempo.

Sintaxis

HRESULT SetOptions(
  [in, optional] IN PDEVMODE                      pDevmode,
  [in]           IN DWORD                         cbSize,
  [in]           IN BOOL                          bResolveConflicts,
  [in]           IN const PRINT_FEATURE_OPTION [] pFOPairs,
  [in]           IN DWORD                         cPairs,
  [out]          OUT PDWORD                       pcPairsWritten,
  [out]          OUT PDWORD                       pdwResult
);

Parámetros

[in, optional] pDevmode

Puntero a una estructura DEVMODEW . Si se proporciona este puntero, IPrintCoreHelperPS::SetOptions debe usar la estructura DEVMODEW a la que apunta pDevmode en lugar de la estructura DEVMODEW predeterminada o actual. Si se llama a este método desde el proveedor del complemento o desde IPrintOemPS::D evMode, se requiere este parámetro. En la mayoría de las otras situaciones, el parámetro debe ser NULL. Cuando el controlador principal establece pDevmode en NULL, modifica su estado interno en lugar del de la estructura DEVMODEW pasada. Esto es necesario durante operaciones como el reemplazo completo de la interfaz de usuario, donde la estructura DEVMODEW devuelta por un DDI, como DrvDocumentPropertySheets, está siendo administrada por el módulo de interfaz de usuario del controlador principal.

[in] cbSize

Tamaño, en bytes, de la estructura DEVMODEW a la que apunta el parámetro pDevmode .

[in] bResolveConflicts

Valor booleano que indica si IPrintCoreHelperPS::SetOptions debe resolver conflictos que surgen de una o varias restricciones en la vista PPD del archivo de configuración, así como restricciones para la funcionalidad implementada por Pscript o el procesador de impresión. Si es TRUE, este método debe intentar resolver el conflicto. Si es FALSE, este método no debe intentar resolver conflictos.

[in] pFOPairs

Matriz de elementos PRINT_FEATURE_OPTION , donde cada elemento contiene un par de opciones de características. Cada par de opciones de características muestra una característica y la opción que se va a seleccionar para esa característica. Todas las configuraciones se aplican secuencialmente. No se permiten duplicados, pero la configuración que aparece más adelante en la matriz (es decir, en un índice superior) invalida las que aparecen anteriormente en la matriz.

[in] cPairs

Número de pares de opción de características a los que apunta el parámetro pFOPairs .

[out] pcPairsWritten

Puntero a una variable que recibe el número de pares de opción de características que se guardaron correctamente antes de que IPrintCoreHelperPS::SetOptions devolvió o produjo un error. Si este método devuelve correctamente, pcPairsWritten tendrá el mismo valor que cPairs. Si se produce un error en el método, pcPairsWritten puede tener cualquier valor de cero a través del valor de cPairs. Este parámetro es opcional y puede ser NULL.

[out] pdwResult

Puntero a una variable que recibe el estado de la resolución de conflictos. El estado puede ser uno de los valores siguientes.

Valor	Descripción
SETOPTIONS_RESULT_NO_CONFLICT	No se infringió ninguna restricción especificada en la vista PPD del archivo de configuración, en relación con la nueva configuración.
SETOPTIONS_RESULT_CONFLICT_RESOLVED	Se infringió al menos una restricción especificada en la vista PPD del archivo de configuración y el autor de la llamada solicitó que el método resolvera conflictos. Este valor da como resultado una configuración modificada con conflictos resueltos.
SETOPTIONS_RESULT_CONFLICT_NOT_RESOLVED	Se infringió al menos una restricción especificada en la vista PPD del archivo de configuración y el autor de la llamada solicitó que el método no debería resolver conflictos. La configuración no cambia y los conflictos permanecen.

Valor devuelto

IPrintCoreHelperPS::SetOptions debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_INVALIDARG	Uno o varios de los argumentos no son válidos o no se admite la característica.
E_OUTOFMEMORY	No se pudo asignar memoria para la matriz de resultados.

Para otros errores, el método debe devolver un código de error COM estándar.

Comentarios

IPrintCoreHelperPS::SetOptions se puede usar para realizar varios cambios de configuración simultáneamente y para resolver restricciones una vez establecidas todas las opciones seleccionadas. Los cambios en las opciones se aplican secuencialmente, empezando desde el principio de la matriz pFOPairs , por lo que si la misma característica aparece dos veces en esta matriz, solo se seleccionará la última opción de la característica. Los cambios en las opciones no se confirman a menos que el parámetro bResolveConflicts sea TRUE.

Para la mayoría de los escenarios, el parámetro bResolveConflicts debe establecerse en TRUE. Establezca este parámetro en FALSE si desea pedir al usuario que resuelva los conflictos.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (incluya Prcomoem.h)

Consulte también

IPrintCoreHelperPS

IPrintCoreHelperPS::GetOptions