IPrintTicketProvider::GetSupportedVersions 메서드(prdrvcom.h)

  • 아티클

IPrintTicketProvider::GetSupportedVersions 메서드는 플러그 인 공급자가 지원하는 인쇄 스키마의 주 버전 번호를 검색합니다.

구문

HRESULT GetSupportedVersions(
  [in]  IN HANDLE    hPrinter,
  [out] OUT INT * [] ppVersions,
  [out] OUT INT      *cVersions
);

매개 변수

[in] hPrinter

인쇄 디바이스에 대한 핸들입니다.

[out] ppVersions

버전 번호 배열의 첫 번째 요소 주소를 받는 변수에 대한 포인터입니다. 배열의 버전 번호는 순서에 따라 표시할 수 있습니다. 이 매개 변수에 대한 자세한 내용은 다음 주의 섹션을 참조하세요.

[out] cVersions

ppVersions에서 가리키는 배열의 요소 수를 수신하는 변수에 대한 포인터입니다.

반환 값

IPrintTicketProvider::GetSupportedVersions 는 작업이 성공하면 S_OK 반환해야 합니다. 메모리 또는 기타 리소스 부족으로 인해 이 메서드가 실패하는 경우 표준 COM 오류 코드를 반환해야 합니다.

설명

IPrintTicketProvider::GetSupportedVersions 는 공급자 인터페이스에서 지원하는 인쇄 스키마의 주 버전 번호를 반환합니다. 현재 정의된 유일한 버전 번호는 1입니다. 공급자는 중간 버전을 생략할 수 있습니다.

플러그 인은 ppVersions 매개 변수가 가리키는 배열 메모리를 할당합니다. 플러그 인은 Microsoft Windows SDK 설명서에 설명된 CoTaskMemAlloc 함수를 사용하여 이 메모리를 할당해야 하지만 플러그 인은 이 메모리를 해제할 책임이 없습니다.

IPrintTicketProvider::GetSupportedVersions는 IPrintTicketProvider::BindPrinter 메서드가 호출되기 전에 호출할 수 있으므로 OEM 플러그 인 공급자는 hPrinter 매개 변수에 전달된 핸들에 따라 버전 지원을 검사 합니다. 따라서 OEM 플러그 인 공급자는 hPrinter와 연결된 프린터 핸들을 닫지 않아야 합니다.

요구 사항

요구 사항 값
헤더 prdrvcom.h(Prdrvcom.h 포함)

추가 정보

IPrintTicketProvider

IPrintTicketProvider::BindPrinter