다음을 통해 공유

AddPrintDeviceObject 함수(winsplp.h)

  • 아티클

경고

Windows 10 타사 인쇄 공급자를 지원하는 API는 더 이상 사용되지 않습니다. Microsoft는 타사 인쇄 공급자에 대한 투자를 권장하지 않습니다. 또한 v4 인쇄 드라이버 모델을 사용할 수 있는 Windows 8 최신 제품에서는 타사 인쇄 공급자가 v4 인쇄 드라이버를 사용하는 큐를 만들거나 관리할 수 없습니다.

AddPrintDeviceObject 인쇄 공급자 함수는 인쇄 공급자 큐에 대한 디바이스 개체를 만듭니다.

구문

HRESULT AddPrintDeviceObject(
  [in]  HANDLE hPrinter,
  [out] HANDLE *phDeviceObject
);

매개 변수

[in] hPrinter

열려 있는 프린터에 대한 핸들입니다. AddPrinter 또는 OpenPrinter 스풀러 함수에서 반환하는 HANDLE이어야 합니다.

[out] phDeviceObject

성공적으로 만들어진 경우 디바이스 개체에 대한 HANDLE입니다.

반환 값

AddPrintDeviceObject 함수는 디바이스 개체가 성공적으로 만들어진 경우 S_OK 반환합니다. 그렇지 않으면 오류가 반환됩니다.

설명

다음과 같은 상황에서 AddPrintDeviceObject 함수를 호출해야 합니다.

사용자가 프린터를 설치합니다.

  • 인쇄 공급자는 프린터를 설치한 후 이 함수를 호출해야 합니다.

  • 프린터를 설치하는 사용자를 가장하여 함수를 호출해야 합니다.

인쇄 공급자는 공급자가 소유한 이전에 설치된 각 프린터에 대해 이 함수를 호출해야 합니다. 이 시간 동안 AddPrintDeviceObject 는 호출 시 사용자 컨텍스트를 가장할 필요가 없습니다.

AddPrintDeviceObject를 사용하여 추가된 모든 디바이스 개체는 RemovePrintDeviceObject를 사용하여 제거할 때까지 또는 스풀러 서비스가 다시 시작될 때까지 유지됩니다. 스풀러 서비스가 중지되면 모든 디바이스 개체가 자동으로 삭제됩니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 winsplp.h(Winspool.h 포함)
라이브러리 WinSpool.lib
DLL WinSpool.drv

추가 정보

RemovePrintDeviceObject