IPrintCoreHelperPS::GetFeatureAttribute 메서드(prcomoem.h)

아티클
02/26/2024

IPrintCoreHelperPS::GetFeatureAttribute 메서드는 기능 특성 목록 또는 특정 기능 특성의 값을 검색합니다.

구문

HRESULT GetFeatureAttribute(
  [in]  PCSTR  pszFeatureKeyword,
  [in]  PCSTR  pszAttribute,
  [out] PDWORD pdwDataType,
  [out] PBYTE  *ppbData,
  [out] PDWORD pcbSize
);

매개 변수

[in] pszFeatureKeyword

쿼리할 기능 키워드(keyword) 지정하는 ANSI 문자열을 포함하는 호출자 제공 버퍼에 대한 포인터입니다. 이 값은 IPrintCoreHelperPS::EnumFeatures에 대한 이전 호출에서 가져올 수 있습니다.

[in] pszAttribute

요청된 특성을 지정하는 ANSI 문자열을 포함하는 호출자 제공 버퍼에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 호출자는 특정 기능 특성 이름을 지정하는 대신 지원되는 모든 기능 특성 이름 목록을 요청합니다.

[out] pdwDataType

요청된 특성의 데이터 형식을 지정하는 값을 받는 변수에 대한 포인터입니다. 이 값은 printoem.h에 정의된 EATTRIBUTE_DATATYPE 열거형 형식의 열거자입니다.

[out] ppbData

요청된 데이터를 포함하는 호출 수신자 할당 버퍼에 대한 포인터입니다. 이 메서드가 완료되면 호출자는 이 버퍼를 해제할 필요가 없습니다.

[out] pcbSize

pbData 매개 변수가 가리키는 버퍼의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

IPrintCoreHelperPS::GetFeatureAttribute 는 다음 값 중 하나를 반환해야 합니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_FAIL	메서드가 실패했습니다.
E_INVALIDARG	메서드가 존재하지 않는 특성을 쿼리하려고 했습니다. 이 값은 기능 키워드(keyword) 인식되지 않음을 의미할 수도 있습니다.
E_OUTOFMEMORY	pcbSize의 값은 pbData가 가리키는 출력 버퍼에 쓸 바이트 수보다 작습니다. 이 값은 pbData 가 NULL로 설정된 상태에서 메서드가 호출되었음을 의미할 수도 있습니다.

설명

iPrintCoreHelperPS::GetFeatureAttribute가 pszAttribute 및 pbData 매개 변수를 NULL로 설정하여 호출되면 메서드는 pcbSize가 기능의 지원되는 모든 특성 이름 목록에 필요한 바이트 수로 설정된 상태로 반환됩니다. 이 메서드가 두 번째로 호출되면 pszAttribute 가 NULL 로 설정되고 pbData 가 이전 호출에서 pcbSize 에 지정된 크기의 버퍼를 가리키는 경우 메서드는 pdwDataType 이 kADT_ASCII( EATTRIBUTE_DATATYPE 열거형 형식의 열거자)로 설정된 상태로 반환되고 pbData 는 기능에 대해 지원되는 모든 특성 이름의 NULL로 구분된 목록을 가리킵니다. 이 목록은 두 개의 null 문자로 종료됩니다.