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

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

구문

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

매개 변수

[in] bstrKeyName

기능의 키 이름입니다.

[out, retval] ppFeature

반환된 기능입니다.

반환 값

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

설명

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

Name	인쇄 스키마 기능 공용 이름	특수 옵션 유형
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를 통해 쿼리해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
대상 플랫폼	데스크톱
머리글	printerextension.h

추가 정보

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption

IPrintSchemaPageMediaSizeOption