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

Artigo
02/29/2024

Obtém um recurso nomeado do PrintTicket, por nome e URI de namespace completo.

Sintaxe

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

Parâmetros

[in] bstrName

O nome base do valor do atributo de nome do elemento de recurso. Por exemplo, para o recurso <esquema de impressão psf:Nome do recurso="psk:JobOutputBin",> o nome base do recurso é "JobOutputBin".

[in] bstrNamespaceUri

O URI do namespace do valor do atributo name do elemento de recurso. Por exemplo, o URI do namespace do recurso público de Esquema de Impressão "JobOutputBin" é "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". Se o recurso não estiver definido no Esquema de Impressão público, esse deverá ser o URI do namespace privado que define o recurso.

[out, retval] ppFeature

O recurso retornado.

Retornar valor

Esse método retorna um valor HRESULT .

Comentários

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.