DrvUpgradePrinter 함수(winddiui.h)

  • 아티클

프린터 인터페이스 DLL의 DrvUpgradePrinter 함수는 새 버전의 드라이버가 시스템에 추가되면 프린터의 레지스트리 설정을 업데이트하는 데 사용됩니다.

구문

BOOL DrvUpgradePrinter(
                 DWORD  Level,
  [in, optional] LPBYTE pDriverUpgradeInfo
);

매개 변수

Level

다음 표에 표시된 대로 pDriverUpgradeInfo가 가리키는 구조체의 형식을 나타내는 호출자 제공 값입니다.

수준 값 pDriverUpgradeInfo가 가리키는 구조체
1 DRIVER_UPGRADE_INFO_1
2 DRIVER_UPGRADE_INFO_2

[in, optional] pDriverUpgradeInfo

형식이 dwLevel로 식별되는 구조체에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다 . 그렇지 않으면 SetLastError를 호출하여 오류 코드를 설정하고 FALSE를 반환해야 합니다.

설명

프린터 인터페이스 DLL은 필요에 따라 DrvUpgradePrinter 함수를 제공할 수 있습니다. 이 경우 스풀러는 프린터 드라이버가 시스템에 복사되면 모든 프린터에 대해 이를 호출합니다. 이는 시스템이 한 운영 체제 릴리스에서 다음으로 업그레이드되거나 애플리케이션이 Win32 AddPrinterDriver 함수를 호출하여 프린터 드라이버를 업데이트할 때 발생합니다.

새 드라이버 버전에는 이전 버전과 다른 레지스트리 설정이 필요한 경우가 많습니다. DrvUpgradePrinter 함수의 목적은 드라이버와 호환되도록 레지스트리를 업데이트하는 것입니다. 레지스트리에 프린터 정보를 저장하는 방법에 대한 자세한 내용은 DrvPrinterEvent를 참조하세요.

Windows 2000 이상에서는 스풀러가 DrvUpgradePrinter를 호출할 때 pDriverUpgradeInfo에 대한 DRIVER_UPGRADE_INFO_2 구조 포인터를 제공합니다. 함수가 FALSE를 반환하는 경우 스풀러는 함수를 다시 호출하며, 이번에는 DRIVER_UPGRADE_INFO_1 구조체 포인터를 지정합니다. 이 호출이 FALSE를 반환하면 스풀러는 이벤트 로그에 항목을 씁니다.

Windows NT 4.0 이전의 경우 스풀러가 DrvUpgradePrinter를 호출할 때 pDriverUpgradeInfo에 대한 DRIVER_UPGRADE_INFO_1 구조 포인터를 제공합니다. 함수가 FALSE를 반환하면 스풀러는 이벤트 로그에 항목을 씁니다.

요구 사항

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

추가 정보

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent