Método IPrintSchemaTicket::GetFeatureByKeyName (printerextension.h)

Artículo
03/05/2024

Obtiene una característica de PrintTicket basada en el nombre de clave especificado.

Sintaxis

HRESULT GetFeatureByKeyName(
  [in]          BSTR                bstrKeyName,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Parámetros

[in] bstrKeyName

Nombre de clave de la característica.

[out, retval] ppFeature

La característica devuelta.

Valor devuelto

Este método devuelve un valor HRESULT .

Comentarios

Consulte IPrintSchemaCapabilities::GetFeatureByKeyName para conocer los nombres de clave de características reconocidos, los nombres de las características de esquema de impresión público equivalentes de los nombres de clave y los tipos de opciones especializados admitidos.

Cuando no se encuentra la característica, la opción o la propiedad solicitadas, este método devuelve S_FALSE y establece un puntero NULL en el objeto de salida de la característica, opción o propiedad.

Por lo tanto, si el objeto IPrintSchemaTicket no contiene la característica, opción o propiedad especificadas, la aplicación debe obtener un objeto IPrintSchemaCapabilities y consultarlo a través de IPrintSchemaCapabilities::GetFeatureByKeyName o a través de IPrintSchemaCapabilities::GetFeature.