IPrintSchemaCapabilities::GetFeatureByKeyName 메서드(printerextension.h)

지정된 키 이름을 기반으로 PrintCapabilities에서 기능을 가져옵니다.

통사론

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

[in] bstrKeyName

기능의 키 이름입니다.

[out, retval] ppFeature

반환된 기능입니다.

이 메서드는 HRESULT 값을 반환합니다.

다음 기능 키 이름만 인식됩니다. 키 이름은 다음 표와 같이 공용 인쇄 스키마 기능 이름과 동일합니다. 또한 이 표에는 특수 옵션 형식이 있는 기능도 표시됩니다(기본적으로 옵션 형식은 IPrintSchemaOption ).

이름	인쇄 스키마 기능 공용 이름	특수 옵션 유형
DocumentBinding	DocumentBinding 또는 JobBindAllDocuments
DocumentCollate	DocumentCollate
DocumentDuplex	JobDuplexAllDocumentsContiguously
DocumentHolePunch	DocumentHolePunch 또는 JobHolePunch
DocumentInputBin	JobInputBin, DocumentInputBin 또는 PageInputBin
DocumentNUp	JobNUpAllDocumentsContiguously	IPrintSchemaNUpOption
DocumentStaple	JobStapleAllDocuments 또는 DocumentStaple
PageMediaSize	PageMediaSize	IPrintSchemaPageMediaSizeOption
PageMediaType	PageMediaType
PageOrientation	PageOrientation
PageOutputColor	PageOutputColor
PageOutputQuality	PageOutputQuality

요청된 기능, 옵션 또는 속성을 찾을 수 없는 경우 이 메서드는 S_FALSE 반환하고 기능, 옵션 또는 속성의 출력 개체에 NULL 포인터를 설정합니다.

따라서 IPrintSchemaTicket 개체에 지정된 기능, 옵션 또는 속성이 없는 경우 앱은 IPrintSchemaCapabilities 개체를 가져와서 IPrintSchemaCapabilities::GetFeatureByKeyName 통해 또는 IPrintSchemaCapabilities::GetFeature통해 쿼리해야 합니다.

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption

IPrintSchemaPageMediaSizeOption