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

Artigo
02/26/2024

Obtém um recurso do PrintTicket com base no nome da chave especificado.

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.

Retornar valor

Esse método retorna um valor HRESULT .

Comentários

Consulte IPrintSchemaCapabilities::GetFeatureByKeyName para obter os nomes de chave de recurso reconhecidos, os nomes de recursos de esquema de impressão públicos equivalentes dos nomes de chave e os tipos de opções especializadas com suporte.

Quando o recurso solicitado, a opção ou a propriedade não é encontrado, 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, a opção ou a propriedade especificados, o aplicativo deverá obter um objeto IPrintSchemaCapabilities e consultá-lo por meio de IPrintSchemaCapabilities::GetFeatureByKeyName ou via IPrintSchemaCapabilities::GetFeature.