다음을 통해 공유

IPrintOemUI::UpgradePrinter 메서드(prcomoem.h)

  • 아티클

IPrintOemUI::UpgradePrinter 메서드를 사용하면 사용자 인터페이스 플러그 인이 레지스트리에 저장된 디바이스 옵션 값을 업그레이드할 수 있습니다.

구문

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

매개 변수

dwLevel

pDriverUpgradeInfo가 가리키는 구조체의 호출자 제공 버전 번호입니다. 현재 유효한 값은 1입니다.

pDriverUpgradeInfo

DRIVER_UPGRADE_INFO_1 구조체에 대한 호출자 제공 포인터입니다.

반환 값

메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드 Description
S_OK
 작업에 성공했습니다.
E_FAIL
 작업이 실패했습니다.
E_NOTIMPL
 메서드가 구현되지 않았습니다.

설명

Microsoft 프린터 드라이버 중 하나에 대한 사용자 인터페이스 플러그 인을 제공하고 사용자 인터페이스 플러그 인이 레지스트리에 디바이스 옵션 값을 저장하는 경우 해당 값을 업데이트하는 메서드를 구현 IPrintOemUI::UpgradePrinter 해야 합니다.

사용자 인터페이스 플러그 인의 IPrintOemUI::UpgradePrinter 메서드는 사용자 모드 프린터 인터페이스 DLL로 내보낸 DrvUpgradePrinter 함수와 동일한 유형의 작업을 수행합니다. 드라이버의 DrvUpgradePrinter 함수가 호출되면 자체 레지스트리 값을 업데이트한 다음 메서드를 IPrintOemUI::UpgradePrinter 호출합니다.

여러 사용자 인터페이스 플러그 인에서 메서드를 내보낼 경우 IPrintOemUI::UpgradePrinter 플러그 인이 설치를 위해 지정된 순서대로 메서드가 호출됩니다.

사용자 인터페이스 플러그 인을 만들고 설치하는 방법에 대한 자세한 내용은 Microsoft의 프린터 드라이버 사용자 지정을 참조하세요.

요구 사항

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