Método IPrintCoreHelperPS::EnumConstrainedOptions (prcomoem.h)
El método IPrintCoreHelperPS::EnumConstrainedOptions proporciona una lista de todas las opciones restringidas en una característica determinada, en función de la configuración actual.
Sintaxis
HRESULT EnumConstrainedOptions(
[in, optional] IN const DEVMODE *pDevmode,
[in] IN DWORD cbSize,
[in] IN PCSTR pszFeatureKeyword,
[out] OUT PCSTR * [] pConstrainedOptionList,
[out] OUT DWORD *pdwNumOptions
);
Parámetros
[in, optional] pDevmode
Puntero a una estructura DEVMODEW . Si se proporciona este puntero, IPrintCoreHelperPS::EnumConstrainedOptions 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 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 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
Cadena de caracteres ANSI que contiene el nombre de la característica.
[out] pConstrainedOptionList
Puntero a una matriz de cadenas de caracteres ANSI. Cuando se devuelve IPrintCoreHelperPS::EnumConstrainedOptions , estas cadenas contendrán los nombres de todas las opciones restringidas dentro de la característica especificada. El autor de la llamada no es responsable de liberar la matriz o las cadenas individuales de la matriz.
[out] pdwNumOptions
Puntero a una variable que recibe el número de opciones restringidas de la matriz a la que apunta el parámetro pConstrainedOptionList .
Valor devuelto
IPrintCoreHelperPS::EnumConstrainedOptions debe devolver uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
| S_OK | Las opciones restringidas se establecieron para la característica especificada. |
| E_FAIL | El autor de la llamada proporcionó información que dio lugar a una solicitud no válida, como una solicitud de una característica que no existe. |
| E_INVALIDARG | Uno o varios de los argumentos no eran válidos. Este valor puede significar que no se admite la característica. |
| E_OUTOFMEMORY | No había suficiente memoria para crear la matriz de opciones o el controlador principal no pudo atender la solicitud debido a la falta de memoria. |
| E_UNEXPECTED u otros errores que no aparecen aquí | Condición inesperada. El controlador principal probablemente está en un estado no válido. El autor de la llamada debe salir con un código de error. |
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | prcomoem.h (include Prcomoem.h) |