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

IPrintCoreHelperPS::GetGlobalAttribute 메서드는 전역 특성 목록 또는 특정 전역 특성의 값을 검색합니다.

구문

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

매개 변수

[in] pszAttribute

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

[out] pdwDataType

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

[out] ppbData

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

[out] pcbSize

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

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_FAIL	메서드가 실패했습니다.
E_INVALIDARG	메서드가 존재하지 않는 특성을 쿼리하려고 했습니다.
E_OUTOFMEMORY	pcbSize의 값이 pbData가 가리키는 출력 버퍼에 쓸 바이트 수보다 작습니다.

설명

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

IPrintCoreHelperPS::GetGlobalAttribute에 대한 자세한 내용은 GetGlobalAttribute 사용을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	prcomoem.h(Prcomoem.h 포함)

추가 정보

IPrintCoreHelperPS

IPrintCoreHelperPS::GetFeatureAttribute

IPrintCoreHelperPS::GetOptionAttribute