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

Artículo
03/05/2024

Obtiene una característica con nombre del URI printTicket, por nombre y espacio de nombres completo.

Sintaxis

HRESULT GetFeature(
  [in]          BSTR                bstrName,
  [in]          BSTR                bstrNamespaceUri,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Parámetros

[in] bstrName

Nombre base del valor del atributo name del elemento de característica. Por ejemplo, para la característica <Esquema de impresión psf:Feature name="psk:JobOutputBin",> el nombre base de la característica es "JobOutputBin".

[in] bstrNamespaceUri

URI del espacio de nombres del valor del atributo name del elemento de característica. Por ejemplo, el URI del espacio de nombres de la característica de esquema de impresión público "JobOutputBin" es "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". Si la característica no está definida en el esquema de impresión público, debe ser el URI del espacio de nombres privado que define la característica.

[out, retval] ppFeature

La característica devuelta.

Valor devuelto

Este método devuelve un valor HRESULT .

Comentarios

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.