Método IPrintCoreHelperUni::GetOption (prcomoem.h)

  • Artículo

El IPrintCoreHelperUni::GetOption método obtiene una opción especificada para una característica determinada.

Sintaxis

HRESULT GetOption(
  [in, optional] const DEVMODE *pDevmode,
  [in]           DWORD         cbSize,
  [in]           PCSTR         pszFeatureRequested,
  [out]          PCSTR         *ppszOption
);

Parámetros

[in, optional] pDevmode

Puntero a una estructura DEVMODEW . Si se proporciona este puntero, IPrintCoreHelperUni::GetOption 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 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 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] pszFeatureRequested

Puntero a la cadena ANSI que contiene el nombre de la característica tal como aparece en el archivo GPD.

[out] ppszOption

Puntero a una variable que contiene la dirección de una cadena ANSI. Cuando IPrintCoreHelperUni::GetOption se devuelve, la cadena debe contener la palabra clave de la opción seleccionada actualmente, tal como aparece en el archivo de configuración. El autor de la llamada no debe modificar esta cadena y no debe liberar la memoria asociada a esta cadena.

Valor devuelto

IPrintCoreHelperUni::GetOption debe devolver uno de los valores siguientes.

Código devuelto Descripción
S_OK
 El método lee la opción de la característica especificada.
E_FAIL
 El autor de la llamada proporcionó información que dio lugar a una solicitud no válida. Por ejemplo, la característica solicitada no existe.
E_INVALIDARG
 Los argumentos no eran válidos. Este valor puede significar que la característica no se admite o que se solicitaron demasiadas opciones para la característica.
E_OUTOFMEMORY
 El controlador principal no pudo atender la solicitud porque no había memoria suficiente.
E_UNEXPECTED u otros códigos de retorno que no aparecen aquí
 El controlador principal parece estar en un estado no válido. El autor de la llamada debe devolver un código de error.

Comentarios

IPrintCoreHelperUni::GetOption no se puede usar para las características que permiten establecer varias opciones simultáneamente.

Las palabras clave de característica se definen en el archivo GPD. Además, el controlador Unidrv admite varias palabras clave reservadas para las opciones almacenadas en su estructura DEVMODEW privada. Para obtener la lista de características Unidrv, consulte Asignación de palabras clave.

El autor de la llamada no debe liberar la cadena a la que apunta ppszOption y no debe modificar la cadena de ninguna manera.

Requisitos

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

Consulte también

IPrintCoreHelperUni

IPrintCoreHelperUni::SetOptions