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 |