Método IPrintCoreHelperUni::WhyConstrained (prcomoem.h)
El IPrintCoreHelperUni::WhyConstrained método proporciona una lista de opciones que restringen el par de opciones de características especificado en la configuración actual.
Sintaxis
HRESULT WhyConstrained(
[in, optional] const DEVMODE *pDevmode,
[in] DWORD cbSize,
[in] PCSTR pszFeatureKeyword,
[in] PCSTR pszOptionKeyword,
[out] const PRINT_FEATURE_OPTION **ppFOConstraints,
[out] DWORD *pdwNumOptions
);
Parámetros
[in, optional] pDevmode
Puntero a una estructura DEVMODEW . Si se proporciona este puntero, IPrintCoreHelperUni::WhyConstrained 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 de complementos o desde IPrintOemUni::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 las 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] pszFeatureKeyword
Puntero a una cadena ANSI que contiene el nombre de la característica. El nombre de la característica debe corresponder a la palabra clave que se usa en el archivo GPD.
[in] pszOptionKeyword
Puntero a una cadena ANSI que contiene el nombre de la opción. El nombre de la opción debe corresponder a la palabra clave que se usa en el archivo GPD.
[out] ppFOConstraints
Puntero a una matriz de PRINT_FEATURE_OPTION elementos. Cuando IPrintCoreHelperUni::WhyConstrained se devuelve, la matriz contiene una lista de pares de elementos de características de las opciones que restringen las opciones especificadas en el parámetro pszOptionKeyword .
[out] pdwNumOptions
Puntero a una variable que recibe el número de pares de opción de características de la matriz a las que apunta el parámetro ppFOConstraints .
Valor devuelto
IPrintCoreHelperUni::WhyConstrained debe devolver uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
Uno o varios de los argumentos no son válidos o no se admite la característica. |
|
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
Si el par de opción de características especificado no está restringido, IPrintCoreHelperUni::WhyConstrained devolverá S_OK pero devolverá *pdwFOPairs establecido en 0 y con *ppFOConstraints[0] establecido en NULL.
Tenga en cuenta que los resultados de este método podrían no contener todas las opciones que afectan a la opción seleccionada actualmente. Sin embargo, si hay combinaciones no válidas que enumeran más de dos pares de opción de características, solo se incluirá una opción de la combinación en la lista.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | prcomoem.h (include Prcomoem.h) |