Método IPrintCoreHelper::EnumConstrainedOptions (prcomoem.h)

El método IPrintCoreHelper::EnumConstrainedOptions proporciona una lista de todas las opciones que están 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, IPrintCoreHelper::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 del complemento o desde IPrintOemPS::D evMode o IPrintOemUni::D evMode o desde un proveedor de vales de impresión, 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] pszFeatureKeyword

Cadena de caracteres ANSI que contienen el nombre de la característica.

[out] pConstrainedOptionList

Puntero a una matriz de cadenas de caracteres ANSI. Cuando se devuelve IPrintCoreHelper::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

IPrintCoreHelper::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 se enumeran explícitamente aquí	Condición inesperada. Es probable que el controlador principal 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 (incluya Prcomoem.h)

Consulte también

IPrintCoreHelper

IPrintCoreHelper::EnumOptions

IPrintCoreHelper::WhyConstrained