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

Artigo
02/07/2025

Obtém um recurso das PrintCapabilities com base em um determinado nome de chave.

Sintaxe

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

Parâmetros

[in] bstrKeyName

O nome da chave do recurso.

[out, retval] ppFeature

O recurso retornado.

Valor de retorno

Esse método retorna um valor HRESULT.

Observações

Somente os nomes de chave de recurso a seguir são reconhecidos. Os nomes de chave são equivalentes aos nomes de recursos públicos do Esquema de Impressão, conforme mostrado na tabela a seguir. A tabela também mostra os recursos que têm tipos de opção especializados (por padrão, o tipo de opção é IPrintSchemaOption).

Nome	Nome público do recurso de esquema de impressão	Tipo de opção especializada
DocumentBinding	DocumentBinding ou JobBindAllDocuments
DocumentCollate	DocumentCollate
DocumentDuplex	JobDuplexAllDocumentsContiguously
DocumentHolePunch	DocumentHolePunch ou JobHolePunch
DocumentInputBin	JobInputBin, DocumentInputBin ou PageInputBin
DocumentNUp	JobNUpAllDocumentsContiguously	IPrintSchemaNUpOption
DocumentStaple	JobStapleAllDocuments ou DocumentStaple
PageMediaSize	PageMediaSize	IPrintSchemaPageMediaSizeOption
PageMediaType	PageMediaType
PageOrientation	PageOrientation
PageOutputColor	PageOutputColor
PageOutputQuality	PageOutputQuality

Quando o recurso solicitado, a opção ou a propriedade não são encontrados, esse método retorna S_FALSE e define um ponteiro NULL no objeto de saída do recurso, opção ou propriedade.

Portanto, se o objeto IPrintSchemaTicket não contiver o recurso especificado, Opção ou propriedade, o aplicativo deve obter um objeto IPrintSchemaCapabilities e consultá-lo por meio de IPrintSchemaCapabilities::GetFeatureByKeyName ou via IPrintSchemaCapabilities::GetFeature.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
da Plataforma de Destino	Área de trabalho
cabeçalho	printerextension.h

Consulte também

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption

IPrintSchemaPageMediaSizeOption

Compartilhar via